Create Call Records

post

https://api.apollo.io/api/v1/phone_calls

Endpoint essentials
API key access	`Master API key`
OAuth scopes	`phone_call_write`
Credit usage	`0 credits` Learn more about API pricing and credits.

Use the Create Call Records endpoint to log calls in Apollo that were made using outside systems such as Orum or Nooks. This endpoint can only be used create call records, not to dial prospects.

Query Params

logged

boolean

Set to true if you want to create an individual record for the phone call in Apollo.

user_id[]

array of strings

Designate the caller in your team's Apollo account.

Use the Get a List of Users endpoint to retrieve IDs for all of the users within your Apollo account.

Example: 67e33d527de088000daa60c4

user_id[]

contact_id

string

Designate the contact that was called.

Use the Search for Contacts endpoint to retrieve IDs for all of the contacts within your Apollo account.

Example: 66e34b81740c50074e3d1bd4

account_id

string

Associate the call with an account.

Use the Search for Accounts endpoint to retrieve IDs for all of the accounts within your Apollo account.

Example: 66e9abf95ac32901b20d1a0d

to_number

string

The phone number that you dialed.

Example: 5555550164

from_number

string

The phone number that dialed you.

Example: 5555550164

status

string

The status of the phone call. Possible values include:

queued
ringing
in-progress
completed
no_answer
failed
busy

start_time

date-time

The time when the call started.

Your entry should adhere to the ISO 8601 date-time format. Apollo uses Greenwich Mean Time (GMT) by default. If you do not account for time zone differences, you could add a start time that falls on a different day than you intended.

The value you enter can either adhere to GMT, or you can adjust the time manually by specifiying in hours and minutes how much you want to offset GMT.

Example: 2025-02-15T08:10:30Z; 2025-03-25T10:15:30+05:00Z

end_time

date-time

The time when the call ended.

Your entry should adhere to the ISO 8601 date-time format. Apollo uses Greenwich Mean Time (GMT) by default. If you do not account for time zone differences, you could add a end time that falls on a different day than you intended.

The value you enter can either adhere to GMT, or you can adjust the time manually by specifiying in hours and minutes how much you want to offset GMT.

Example: 2025-05-15T08:10:30Z; 2025-05-25T10:15:30+05:00Z

duration

integer

The duration of the call in seconds. Do not enter minutes.

Examples: 120; 205

phone_call_purpose_id

string

Assign a call purpose to the record.

Call purposes are unique to your team's Apollo account. When you use the Purpose search filter for calls in the Apollo product, you can find the corresponding call purpose ID in the URL.

Examples: 6095a710bd01d100a506d4cd

phone_call_outcome_id

string

Assign a call outcome to the record.

Call outcomes are unique to your team's Apollo account. When you use the Disposition search filter for calls in the Apollo product, you can find the corresponding call outcome ID in the URL.

Examples: 6095a710bd01d100a506d4c5

note

string

Add a note to the call record.

Example: This lead is interested in learning more about our new product line.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

200

401Unauthorized

403Forbidden