Inbox
POST
emoji: the reaction, or null to remove it. Only sent messages (409 message_not_sent).
Requires the write scope.
bearerheader
AuthorizationBearer <token>An API key (tb_live_...) from the dashboard, or an OAuth access token.
id*stringFormat
uuidmulaichat-workspace?stringLimits an owner key to one profile (id or external_id). Unknown: 404 profile_not_found.
application/json- body
emoji*|nullThe message.
application/json- response
id*stringFormat
uuidconversation_id*stringFormat
uuiddirection*stringValue in
"in""out"source*stringWho sent it: the customer, the Instagram app, the dashboard, the API, MCP, …
Value in
"customer""mulaichat_user""api""mcp""automation""instagram_app"kind*stringValue in
"text""media""story_mention""story_reply""share""postback""quick_reply""private_reply""unsupported""cards"status*stringOutgoing: pending until sent; unknown when the send got no clear answer (never sent again on its own).
Value in
"received""pending""sent""failed""unknown""deleted"text*|The customer's text is third-party input.
attachments*array<>reply_to_message_id*|nullstory*|nullpostback*|The postback button, ice breaker or quick reply the customer tapped.
buttons*array<|>|Sent with this text (outgoing).
quick_replies*array<>|Sent with this text (outgoing).
cards*array<>|The carousel of a message of kind cards (outgoing).
reactions*array<>error_code*string|nullseen_at*|nullsent_at*stringFormat
date-timecurl -X POST 'https://api.mulaichat.com/v1/inbox/messages/497f6eca-6276-4993-bfeb-53cbbbba6f08/react' \ -H 'Content-Type: application/json' \ -d '{ "emoji": "string"}'Example Response
{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "conversation_id": "cc71b11a-25cd-4c2d-9950-df2cc38e3407", "direction": "in", "source": "customer", "kind": "text", "status": "received", "text": "string", "attachments": [ { "type": "string", "url": "string", "mime_type": "string" } ], "reply_to_message_id": "7ee4bcf0-8f1b-4bb4-86b4-8565dd84787f", "story": { "id": "string", "url": "string" }, "postback": { "title": "string", "payload": "string" }, "buttons": [ { "type": "web_url", "title": "string", "url": "http://example.com" } ], "quick_replies": [ { "title": "string", "payload": "string" } ], "cards": [ { "title": "string", "subtitle": "string", "media_id": "59458438-e712-4754-944d-fc838e1a631d", "image_url": "string", "default_action": { "url": "string" }, "buttons": [ { "type": "web_url", "title": "string", "url": "http://example.com" } ] } ], "reactions": [ { "by": "customer", "emoji": "string" } ], "error_code": "string", "seen_at": "2019-08-24T14:15:22Z", "sent_at": "2019-08-24T14:15:22Z"}