GET/conversations/{id}/handling_events

List conversation handling events

Lists pause and resume handling events for a conversation, including the teammate and timestamp for each event. Use this operation when you need to review when teammates paused or resumed handling. Access requires the read_conversations OAuth scope.

2 parameters
idstringrequired
The identifier of the conversation whose handling events to list.
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 the conversation's handling events, including the teammate, event type, timestamp, and optional reason.
handling_eventsarray<HandlingEvent>optional
Array of handling events
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.