Call

A log of an inbound or outbound call made with a prospect.

answeredAt
string or null <date-time>

The date and time the call was answered.

completedAt
string or null <date-time>

The date and time the call was completed.

createdAt
string or null <date-time>

The date and time the call record was created in database. This does not necessarily indicate the time the call was made. If you need the time the call was made, please use either dialedAt or answeredAt.

dialedAt
string or null <date-time>

The date and time the call was dialed.

direction
string or null

The call direction from the user’s point of view; must be either "inbound" or "outbound".

externalVendor
string or null <= 255 characters

The voice provider of the call. Can be blank.

from
string or null <= 255 characters

The phone number used to place the call.

note
string or null <= 65535 characters

A custom note associated with this call.

outcome
string or null <= 255 characters

The call’s outcome; must be either "Answered" or "Not Answered".

recordingUrl
string or null <= 255 characters

The URL of the call's audio recording. This field only accepts HTTP and HTTPS values.

returnedAt
string or null <date-time>

The date and time the call was returned.

sequenceAction
string or null <= 255 characters

The action to take on the associated sequence; must be either "Advance", "Finish", "Finish - No Reply", or "Finish - Replied".

shouldRecordCall
boolean or null

Indicated whether or not the call is recorded.

state
string or null <= 255 characters

The call’s current state.

stateChangedAt
string or null <date-time>

The date and time the call’s state last changed.

tags
Array of strings or null

A list of tag values associated with the call (e.g. ["Interested", "Meeting Booked"]).

to
string or null <= 255 characters

The phone number that the call was placed to.

uid
string or null <= 255 characters

The Outreach voice trace id.

updatedAt
string or null <date-time>

The date and time the call was last updated.

userCallType
string or null <= 255 characters

The type of call placed within the Outreach client; must be either "bridge" or "voip".

vendorCallId
string or null <= 63 characters

The call-id as recorded by the voice provider. Can be blank.

voicemailRecordingUrl
string or null <= 1024 characters

The URL of the call’s voicemail audio recording.

{
  • "answeredAt": "2019-08-24T14:15:22Z",
  • "completedAt": "2019-08-24T14:15:22Z",
  • "createdAt": "2019-08-24T14:15:22Z",
  • "dialedAt": "2019-08-24T14:15:22Z",
  • "direction": "string",
  • "externalVendor": "string",
  • "from": "string",
  • "note": "string",
  • "outcome": "string",
  • "recordingUrl": "string",
  • "returnedAt": "2019-08-24T14:15:22Z",
  • "sequenceAction": "string",
  • "shouldRecordCall": true,
  • "state": "string",
  • "stateChangedAt": "2019-08-24T14:15:22Z",
  • "tags": [
    ],
  • "to": "string",
  • "uid": "string",
  • "updatedAt": "2019-08-24T14:15:22Z",
  • "userCallType": "string",
  • "vendorCallId": "string",
  • "voicemailRecordingUrl": "string"
}

Call Relationships

object

The batches associated with the call.

object

The associated call disposition. You can use only the attribute id to filter calls by callDisposition (e.g. filter[callDisposition][id]=X).

object

The associated call purpose. You can use only the attribute id to filter calls by callPurpose (e.g. filter[callPurpose][id]=X).

object

The kaiaCrmRecording associated with the calendar event.

object

The associated opportunity. You can use only the attribute id to filter calls by opportunity (e.g. filter[opportunity][id]=X).

object

The outbound voicemail message played to the callee's voicemail system.

object

The associated phone of the user.

object

The associated phone number of the prospect. You can use only the attribute id to filter calls by phoneNumber (e.g. filter[phoneNumber][id]=X).

object

The associated prospect. You can use only the attribute id to filter calls by prospect (e.g. filter[prospect][id]=X).

object

The associated sequence. You can use only the attribute id to filter calls by sequence (e.g. filter[sequence][id]=X).

object

The associated sequence state. You can use only the attribute id to filter calls by sequenceState (e.g. filter[sequenceState][id]=X).

object

The associated sequence step. You can use only the attribute id to filter calls by sequenceStep (e.g. filter[sequenceStep][id]=X).

object

The associated task. You can use only the attribute id to filter calls by task (e.g. filter[task][id]=X).

object

The associated user. You can use only the attribute id to filter calls by user (e.g. filter[user][id]=X).

{
  • "batches": {},
  • "callDisposition": {},
  • "callPurpose": {},
  • "kaiaCrmRecording": {},
  • "opportunity": {},
  • "outboundVoicemail": {},
  • "phone": {},
  • "phoneNumber": {},
  • "prospect": {},
  • "sequence": {},
  • "sequenceState": {},
  • "sequenceStep": {},
  • "task": {},
  • "user": {}
}

Call Resource Metadata

METADATA NAME DESCRIPTION QUERY PARAM
canWrite A boolean value indicating whether the current API user has write access to this resource. provideAuthorizationMeta
canDelete A boolean value indicating whether the current API user has delete access to this resource. provideAuthorizationMeta
dataConnections The set of connections a given Call has to external sources. provideDataConnections

⌵ Call Actions

Get a Collection of Calls

SecuritybearerAuth and s2sAuthToken
Responses
200

OK

422

JSON error message

get/calls
Request samples 
Response samples 
application/vnd.api+json
{
  • "data": [
    ]
}
Create a New Call
SecuritybearerAuth and s2sAuthToken 
Request 
Request Body schema: application/vnd.api+json
required
object
 
Responses 
201
Created


422
JSON error message


post/calls
Request samples 
application/vnd.api+json
{
  • "data": {
    }
}
Response samples 
application/vnd.api+json
{
  • "data": {
    }
}
Delete an Existing Call by ID
SecuritybearerAuth and s2sAuthToken 
Request 
path Parameters
id
required
integer
 
Responses 
204
Deleted


422
JSON error message


delete/calls/{id}
Request samples 
Response samples 
application/vnd.api+json
{
  • "errors": [
    ]
}
Get a Call by ID
SecuritybearerAuth and s2sAuthToken 
Request 
path Parameters
id
required
integer
 
Responses 
200
OK


404
Not Found


get/calls/{id}
Request samples 
Response samples 
application/vnd.api+json
{
  • "data": {
    }
}