TWtwilio
ConversationsV1Message

Add a new message to the conversation

Changed on

Add a new message to the conversation

post/v1/Conversations/{ConversationSid}/Messages

Request

  • Base URL
    https://conversations.twilio.com
  • URL
    https://conversations.twilio.com/v1/Conversations/{ConversationSid}/Messages
  • Auth
    HTTP basic

Path parameters

ConversationSidstring required

The unique ID of the Conversation for this message.

Headers

X-Twilio-Webhook-Enabled'true' | 'false'

The X-Twilio-Webhook-Enabled HTTP request header

Request body application/x-www-form-urlencoded

Authorstring

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

Bodystring

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

DateCreatedstring date-time

The date that this resource was created. If you set this parameter, Twilio ignores any milliseconds in the timestamp.

DateUpdatedstring date-time

The date that this resource was last updated. null if the message has not been edited. If you set this parameter, Twilio ignores any milliseconds in the timestamp.

Attributesstring

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.

MediaSidstring

The Media SID to be attached to the new Message.

ContentSidstring

The unique ID of the multi-channel Rich Content template, required for template-generated messages. Note that if this field is set, Body and MediaSid parameters are ignored.

ContentVariablesstring

A structurally valid JSON string that contains values to resolve Rich Content template variables.

Subjectstring

The subject of the message, can be up to 256 characters long.

Response

Created

account_sidstring nullable

The unique ID of the Account responsible for this message.

conversation_sidstring nullable

The unique ID of the Conversation for this message.

sidstring nullable

A 34 character string that uniquely identifies this resource.

indexinteger

The index of the message within the Conversation. Indices may skip numbers, but will always be in order of when the message was received.

authorstring nullable

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

bodystring nullable

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

attributesstring nullable

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.

participant_sidstring nullable

The unique ID of messages's author participant. Null in case of system sent message.

date_createdstring date-time nullable

The date that this resource was created.

date_updatedstring date-time nullable

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

urlstring uri nullable

An absolute API resource API URL for this message.

deliveryunknown
linksobject nullable

Contains an absolute API resource URL to access the delivery & read receipts of this message.

content_sidstring nullable

The unique ID of the multi-channel Rich Content template.

Changes

  • v192d1169c37c2Revision changes
    • breaking

      the response's property type changed from object to no type for status

    • breaking

      the / response's property type changed from object to no type for status

  • v1b4d0e634cd69Revision changes
    • breaking

      the response's property type changed from no type to object for status

    • breaking

      the / response's property type changed from no type to object for status