Skip to content
Home/
REST API Reference
/
/
Call

Call

Represents a phone call in Intercom

typestring

String representing the object's type. Always has the value call.

Example:"call"
idstring

The id of the call.

Example:"123"
conversation_idstring or null

The id of the conversation associated with the call, if any.

Example:"456"
admin_idstring or null

The id of the admin associated with the call, if any.

Example:"789"
contact_idstring or null

The id of the contact associated with the call, if any.

Example:"6762f0dd1bb69f9f2193bb83"
statestring

The current state of the call.

Example:"completed"
initiated_atstring (string) or integer (integer)(datetime)
One of:

A date and time following the ISO8601 notation.

string (date-time)(string)
answered_atstring (string) or integer (integer)(datetime)
One of:

A date and time following the ISO8601 notation.

string (date-time)(string)
ended_atstring (string) or integer (integer)(datetime)
One of:

A date and time following the ISO8601 notation.

string (date-time)(string)
created_atstring (string) or integer (integer)(datetime)
One of:

A date and time following the ISO8601 notation.

string (date-time)(string)
updated_atstring (string) or integer (integer)(datetime)
One of:

A date and time following the ISO8601 notation.

string (date-time)(string)
recording_urlstring or null, (uri)

API URL to download or redirect to the call recording if available.

Example:"https://api.intercom.io/calls/123/recording"
transcription_urlstring or null, (uri)

API URL to download or redirect to the call transcript if available.

Example:"https://api.intercom.io/calls/123/transcript"
call_typestring

The type of call.

Example:"phone"
directionstring

The direction of the call.

Example:"outbound"
ended_reasonstring or null

The reason for the call end, if applicable.

Example:"completed"
phonestring or null

The phone number involved in the call, in E.164 format.

Example:"+15551234567"
fin_recording_urlstring or null, (uri)

API URL to the AI Agent (Fin) call recording if available.

fin_transcription_urlstring or null, (uri)

API URL to the AI Agent (Fin) call transcript if available.

{
  "type": "call",
  "id": "123",
  "conversation_id": "456",
  "admin_id": "789",
  "contact_id": "6762f0dd1bb69f9f2193bb83",
  "state": "completed",
  "initiated_at": "2019-08-24T14:15:22Z",
  "answered_at": "2019-08-24T14:15:22Z",
  "ended_at": "2019-08-24T14:15:22Z",
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z",
  "recording_url": "https://api.intercom.io/calls/123/recording",
  "transcription_url": "https://api.intercom.io/calls/123/transcript",
  "call_type": "phone",
  "direction": "outbound",
  "ended_reason": "completed",
  "phone": "+15551234567",
  "fin_recording_url": "http://example.com",
  "fin_transcription_url": "http://example.com"
}