Send a Message

Choose the right SDK create-message API for each chat message type.

Use message creation APIs after your app has resolved the target subChannelId. Text and custom messages send structured data directly. Media messages send an uploaded file ID, attachment object, or file URI depending on platform.

Text

Send plain text with optional tags, metadata, mentions, and reply parent IDs.

Image

Send image messages with platform-specific file ID, attachment, or URI input.

File

Send generic file attachments.

Video

Send video attachments where the platform SDK supports video message creation.

Audio

Send audio attachments on TypeScript, iOS, and Android.

Custom

Send app-defined JSON-style message payloads.

Parameters

Parameter	Required	Description
subChannelId	Yes	Target subchannel where the message will be created.
Message type	Yes	SDK-specific message type selector, such as dataType: 'text', createTextMessage(...), or .text(...).
Message body	Depends	Required for text and custom messages; use text strings or JSON-serializable custom payloads.
Media input	Depends	Required for media messages; use a TypeScript file ID, native attachment, or Flutter Uri depending on platform.
parentId	No	Parent message ID when creating a reply instead of a top-level message.
tags	No	App-defined tags for later filtering or grouping.
metadata	No	App-defined JSON-style metadata stored with the message.

Send A Text Message

Create a text message after resolving the target subChannelId.

TypeScript

import { MessageRepository } from '@amityco/ts-sdk';

const { data: message } = await MessageRepository.createMessage({
  subChannelId,
  dataType: 'text',
  data: {
    text: 'Hello from chat',
  },
});

renderResults(message);

Return Shapes

Platform	Create call result
TypeScript	Resolves to { data: Amity.Message, cachedAt?: number }
iOS	Returns AmityMessage from the async repository call
Android	Returns a Completable; observe the message list for the created message
Flutter	Returns Future<AmityMessage>

Related Topics

Text Message

Add text, tags, metadata, mentions, and replies.

Reply to a Message

Use parentId to create message replies.

Query Messages

Observe sent messages in the target subchannel.

Message Flagging

Add report actions to sent or received messages.