Skip to main content
MUTATION
conversationMessageAdd(conversationId: String, type: String, text: MessageTextInput, media: MessageMediaInput, sender: MessageSenderInput, visibility: String, context: MessageContextInput, template: JSON, metadata: JSON, interactive: JSON): ConversationMessage

Arguments

conversationId
String

The conversation ID to add the message to.

type
String

Message type discriminator: 'text', 'media', 'template', etc.

text
MessageTextInput

Text content of the message.

media
MessageMediaInput

Media content (attachments).

sender
MessageSenderInput

Who is sending this message.

visibility
String

Visibility level: 'public', 'internal', or 'hidden'.

context
MessageContextInput

Threading, forwarding, and mention context.

template
JSON

Template content for template messages.

metadata
JSON

Additional metadata as JSON.

interactive
JSON

Interactive message payload (buttons, lists, carousels) for WhatsApp/Instagram/Facebook.

Returns

ConversationMessage
_id
String!
type
String

Message type discriminator.

sender
MessageSender

Who sent this message.

visibility
String

Visibility level: 'public', 'internal', or 'hidden'.

text
MessageText

Text content (when type='text').

media
MessageMedia

Media content (image, audio, video, document — single or multiple).

template
MessageTemplate

Template content (when type='template').

interactive
MessageInteractive

Interactive content (when type='interactive').

toolCalls
JSON

Tool call data (when type='tool_call').

email
MessageEmail

Email envelope and body (when type='email').

context
MessageContext

Threading, forwarding, mention context.

delivery
MessageDelivery

Delivery status and error info.

reactions
[MessageReaction]

Reactions on this message.

origin
MessageOrigin

External origin tracking.

editHistory
[MessageEditEntry]

Message edit history.

metadata
JSON

Extensible metadata bucket.

replyForMsg
JSON

The resolved original message being replied to.

customer
Customer

The resolved customer who sent this message.

user
User

The resolved agent who sent this message.

conversation
Conversation

The parent conversation.

conversationId
String

The conversation this message belongs to.

createdAt
Date

When this message was created.

sticker
WASticker

Sticker attachment (when type='sticker').

location
WALocation

Location data (when type='location').

contacts
[WAContact]

Contact cards (when type='contacts').

system
MessageSystem

System event content (when type='system').

form
MessageForm

Form submission content (when type='form').

engage
MessageEngage

Engage/campaign content (when type='engage').

videoCall
MessageVideoCall

Video call content (when type='videoCall').

order
MessageOrder

Order/commerce content (when type='order').

referral
WAReferral

WhatsApp ad referral data.

updatedAt
Date

When this message was last updated.

Mutation
Response
Last modified on August 8, 2026

Related topics

Connect AI apps to hosted MCPconversationMessageUpdateconversationMessageconversationMessagesConversationMessage