Skip to navigation

Get conversation

Get details about an individual conversation. Conversations has been deprecated in favor of Inbox and these endpoints don’t include Inbox data. Past Conversations are still available via this endpoint, but new campaign replies and other Inbox messages aren’t available using this endpoint.

Authentication

AuthorizationBearer

Authorization using a Mailchimp API key (a.k.a. Bearer token)

OR
AuthorizationBearer
Authorization using OAuth

Path parameters

conversation_idstringRequired
The unique id for the conversation.

Query parameters

fieldslist of stringsOptional

A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.

exclude_fieldslist of stringsOptional

A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.

Response

This endpoint returns an object.
campaign_idstringOptionalRead-only
The unique identifier of the campaign for this conversation.
from_emailstringOptionalRead-only
A label representing the email of the sender of this message.
from_labelstringOptionalRead-only
A label representing the sender of this message.
idstringOptionalRead-only
A string that uniquely identifies this conversation.
last_messageobjectOptional
The most recent message in the conversation.
list_idstringOptionalRead-only
The unique identifier of the list for this conversation.
message_countintegerOptionalRead-only
The total number of messages in this conversation.
subjectstringOptionalRead-only
The subject of the message.
unread_messagesintegerOptionalRead-only
The number of unread messages in this conversation.