Intercom API (unofficial showcase)
GET/conversations/{id}/side_conversations

List side conversations

Lists internal side conversations and their conversation parts for a given conversation. Use page and per_page to paginate the results. Access requires the read_conversations OAuth scope.

4 parameters
idstringrequired
The identifier of the conversation whose side conversations to list.
pageintegeroptional
The page number of results to return, starting at 1. Defaults to 1 when omitted.
Default:1
per_pageintegeroptional
The number of side conversations to return per page, up to 50. Defaults to 25 when omitted.
Default:25
Intercom-Versionstringoptional
The Intercom API version to use. Defaults to 2.17 when omitted.
Allowed:1.01.11.21.31.42.02.12.22.32.42.52.6Default:2.17

3 status codes
200Returns a page of side conversations with their conversation parts, the total count, and pagination metadata.
typestringoptional
The type of the response object.
Allowed:side_conversation.list
side_conversationsarray<SideConversationSummary>optional
An array of side conversation objects.
total_countintegeroptional
The total number of side conversations.
pagesobjectoptional
Pagination metadata.
401Returned when the request is not authenticated or lacks the required OAuth scope.
typestringrequired
The type is error.list
request_idstringoptional
errorsarray<object>required
An array of one or more error objects
404Returned when the conversation cannot be found.
typestringrequired
The type is error.list
request_idstringoptional
errorsarray<object>required
An array of one or more error objects

Error handling

A 401 is returned when authentication is missing or the request lacks the read_conversations OAuth scope. A 404 is returned when the id path parameter does not identify a conversation. per_page cannot exceed 50.