v1

latestOpenAPI 3.1.02026-07-247601.0 MB

Calls

Create Call Records

This endpoint doesn't consume Apollo 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. This endpoint requires a master API key. If you call the endpoint without a master key, you receive a 403 response. Check out <a href="https://docs.apollo.io/docs/create-api-key">Create an API Key</a> to learn how to create a master key.

post/phone_calls

Query parameters

loggedboolean

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

user_id[]string[]

Designate the caller in your team's Apollo account. Use the <a href="https://docs.apollo.io/reference/get-a-list-of-users" target="_blank">Get a List of Users endpoint</a> to retrieve IDs for all of the users within your Apollo account. Example: 67e33d527de088000daa60c4

contact_idstring

Designate the contact that was called. Use the <a href="https://docs.apollo.io/reference/search-for-contacts#/" target="_blank">Search for Contacts endpoint</a> to retrieve IDs for all of the contacts within your Apollo account. Example: 66e34b81740c50074e3d1bd4

account_idstring

Associate the call with an account. Use the <a href="https://docs.apollo.io/reference/search-for-accounts#/" target="_blank">Search for Accounts endpoint</a> to retrieve IDs for all of the accounts within your Apollo account. Example: 66e9abf95ac32901b20d1a0d

to_numberstring

The phone number that you dialed. Example: 5555550164

from_numberstring

The phone number that dialed you. Example: 5555550164

statusstring

The status of the phone call. Possible values include: <ul> <li>queued</li> <li>ringing</li> <li>in-progress</li> <li>completed</li> <li>no_answer</li> <li>failed</li> <li>busy</li></ul>

start_timestring 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_timestring 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

durationinteger

The duration of the call in seconds. Do not enter minutes. Examples: 120; 205

phone_call_purpose_idstring

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_idstring

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

notestring

Add a note to the call record. Example: This lead is interested in learning more about our new product line.