Skip to main content
MessagesVersion: v3

Get messages by conversation id

GET/conversations/{conversationId}/messages

Get messages by conversation id.

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your access token.

Scope:conversations/message.readonly
Auth methods:OAuthPrivate Integration
Token type:Sub-Account Token

Request​

Headers

Versionstringrequired

API Version

Available optionsv3

Path Parameters

conversationIdstringrequired

Conversation ID as string

Example:tDtDnQdgm2LXpyiqYvZ6

Query Parameters

lastMessageIdstring

Message ID of the last message in the list as a string

Example:tDtDnQdgm2LXpyiqYvZ6
limitnumber

Number of messages to be fetched from the conversation. Default limit is 20

Example:20
typestring

Types of message to fetched separated with comma

Available optionsTYPE_CALLTYPE_SMSTYPE_EMAILTYPE_FACEBOOKTYPE_GMBTYPE_INSTAGRAMTYPE_WHATSAPPTYPE_ACTIVITY_APPOINTMENTTYPE_ACTIVITY_CONTACTTYPE_ACTIVITY_INVOICETYPE_ACTIVITY_PAYMENTTYPE_ACTIVITY_OPPORTUNITY
Example:TYPE_SMS,TYPE_CALL

Response

List of messages for the conversation id of the given type.

messagesobjectrequired

One page of messages for the conversation