Add a new message to the conversation

POST /v1/Conversations/{ConversationSid}/Messages

A Message resource represents a message in a conversation.

Add a new message to the conversation

Headers

Path parameters

Body

  • Attributes string

    A string metadata field you can use to store any data you wish. The string value must contain structurally valid JSON if specified. Note that if the attributes are not set "{}" will be returned.

  • Author string

    The channel specific identifier of the message's author. Defaults to system.

  • Body string

    The content of the message, can be up to 1,600 characters long.

  • DateCreated string(date-time)

    The date that this resource was created.

  • DateUpdated string(date-time)

    The date that this resource was last updated. null if the message has not been edited.

  • MediaSid string

    The Media SID to be attached to the new Message.

    Minimum length is 34, maximum length is 34. Format should match the following pattern: ^ME[0-9a-fA-F]{32}$.

Responses

  • 201

    Created

    Hide response attributes Show response attributes object
    • account_sid string | null

      The unique ID of the Account responsible for this message.

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^AC[0-9a-fA-F]{32}$.

    • attributes string | null

      A string metadata field you can use to store any data you wish.

    • author string | null

      The channel specific identifier of the message's author.

    • body string | null

      The content of the message.

    • conversation_sid string | null

      The unique ID of the Conversation for this message.

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^CH[0-9a-fA-F]{32}$.

    • date_created string(date-time) | null

      The date that this resource was created.

    • date_updated string(date-time) | null

      The date that this resource was last updated.

    • delivery

      An object that contains the summary of delivery statuses for the message to non-chat participants.

    • index integer | null

      The index of the message within the Conversation.

    • links object(uri-map) | null

      Absolute URL to access the receipts of this message.

    • media array | null

      An array of objects that describe the Message's media if attached, otherwise, null.

    • participant_sid string | null

      The unique ID of messages's author participant.

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^MB[0-9a-fA-F]{32}$.

    • sid string | null

      A 34 character string that uniquely identifies this resource.

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^IM[0-9a-fA-F]{32}$.

    • url string(uri) | null

      An absolute API URL for this message.
POST /v1/Conversations/{ConversationSid}/Messages 
curl \
 -X POST https://conversations.twilio.com/v1/Conversations/{ConversationSid}/Messages \
 --user "username:password" \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "X-Twilio-Webhook-Enabled: true" \
 -d 'Attributes=string&Author=string&Body=string&DateCreated=2023-05-04T09%3A42%3A00%2B00%3A00&DateUpdated=2023-05-04T09%3A42%3A00%2B00%3A00&MediaSid=string'
Request example 
# Headers
X-Twilio-Webhook-Enabled: true

# Payload
{
  "Attributes": "string",
  "Author": "string",
  "Body": "string",
  "DateCreated": "2023-05-04T09:42:00+00:00",
  "DateUpdated": "2023-05-04T09:42:00+00:00",
  "MediaSid": "string"
}
Request examples 
# Headers
X-Twilio-Webhook-Enabled: true

# Payload
{
  "Attributes": "string",
  "Author": "string",
  "Body": "string",
  "DateCreated": "2024-05-04T09:42:00+00:00",
  "DateUpdated": "2024-05-04T09:42:00+00:00",
  "MediaSid": "string"
}
Response examples (201) 
{
  "account_sid": "string",
  "attributes": "string",
  "author": "string",
  "body": "string",
  "conversation_sid": "string",
  "date_created": "2023-05-04T09:42:00+00:00",
  "date_updated": "2023-05-04T09:42:00+00:00",
  "index": 42,
  "links": {},
  "media": [],
  "participant_sid": "string",
  "sid": "string",
  "url": "https://example.com"
}
Response examples (201) 
{
  "account_sid": "string",
  "attributes": "string",
  "author": "string",
  "body": "string",
  "conversation_sid": "string",
  "date_created": "2024-05-04T09:42:00+00:00",
  "date_updated": "2024-05-04T09:42:00+00:00",
  "index": 42,
  "links": {},
  "media": [],
  "participant_sid": "string",
  "sid": "string",
  "url": "https://example.com"
}