Create message

Adds an instance of a message to an existing conversation timeline with a customer. Interactions with a customer that occured via email, SMS, web or mobile chat, Facebook direct messages or comments, Twitter direct messages or Tweets, voice, Instagram direct messages or WhatsApp messages can be added to the conversation timeline.

Does not sent a message to a customer, only to be used to record the instance of a message. To send a message, first see the Create a draft by customer endpoint.


An existing conversation must be created to add the message. See the Create conversation or Bulk create conversations or Create conversation for customer endpoints.

Any one of the following roles is required for this endpoint:

Legacy RoleEquivalent Permission Set Role

Rate limit

Messages are subject to a rate limit. A single client can create up to 120 messages per minute per customer.

Messages with importedAt in their body will not be subject to the rate limit.

A 429 Too Many Requests response will be returned if the rate limit has been reached for a customer.

Click Try It! to start a request and see the response here!