--- updatedAt: 2026-08-31T15:22:59.000Z agentTools: projectIndex: https://docs.apollo.io/llms.txt --- # Create Call Records
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 to create call records, not to dial prospects. # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "apollo-rest-api", "summary": "Programmatic access to Apollo's sales intelligence and engagement platform — data enrichment, prospect and company search, and go-to-market workflow management.", "description": "The Apollo API provides programmatic access to [Apollo](https://www.apollo.io/), the all-in-one sales intelligence and engagement platform. Use it to enrich people and company data (individually or in bulk), search Apollo's database of over 240 million contacts and 30 million companies, and manage accounts, contacts, deals, sequences, tasks, calls, and conversations in your go-to-market workflows.\n\n## Base URL\n\nAll API requests are made to `https://api.apollo.io/api/v1`.\n\n## Authentication\n\n- **Apollo users** authenticate with an API key passed in the `x-api-key` request header. See [Create API Keys](https://docs.apollo.io/docs/create-api-key).\n- **Apollo partners** building integrations on behalf of mutual users authenticate with the [OAuth 2.0 authorization flow](https://docs.apollo.io/docs/use-oauth-20-authorization-flow-to-access-apollo-user-information-partners).\n\n## Rate limits & credits\n\nRate limits and credit consumption depend on your [Apollo pricing plan](https://docs.apollo.io/docs/api-pricing). Check your current limits and usage with the [view API usage stats and rate limits](https://docs.apollo.io/reference/view-api-usage-stats) endpoint. For more details, see [Rate Limits](https://docs.apollo.io/reference/rate-limits) and the [API FAQs](https://docs.apollo.io/docs/apollo-api-faqs).\n\nNew to the API? Start with the [Apollo API overview](https://docs.apollo.io/reference/apollo-api).", "termsOfService": "https://www.apollo.io/terms/api", "contact": { "name": "Apollo API Support", "url": "https://docs.apollo.io/" }, "version": "1.0" }, "servers": [ { "url": "https://api.apollo.io/api/v1" } ], "tags": [ { "name": "Calls", "description": "Log and update call records made inside or outside Apollo." } ], "components": { "securitySchemes": { "apiKey": { "type": "apiKey", "in": "header", "name": "x-api-key", "description": "[Recommended] API key, passed in the `x-api-key` request header.\nSee [Create API Keys](https://docs.apollo.io/docs/create-api-key)." }, "bearerAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "JWT", "description": "OAuth 2.0 access token, used by Apollo partners building integrations.\nSee the [OAuth 2.0 authorization flow](https://docs.apollo.io/docs/use-oauth-20-authorization-flow-to-access-apollo-user-information-partners)." } } }, "security": [ { "apiKey": [] }, { "bearerAuth": [] } ], "paths": { "/phone_calls": { "post": { "summary": "Create call records", "description": "## Endpoint essentials\n\n**API key access:** `Master API key`\n\n**OAuth scopes:** `phone_call_write`\n\n**Credit usage:** `0 credits` — [Learn more about API pricing and credits](https://docs.apollo.io/docs/api-pricing).\n\nUse 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.", "tags": [ "Calls" ], "operationId": "phonecalls_create", "responses": { "200": { "description": "", "content": { "application/json": { "examples": { "OK": { "summary": "OK", "value": { "phone_call": { "id": "6859b021b2d6e700212eaf3f", "user_id": "67e33d527de088000daa60c4", "account_id": "6518c6184f20350001a0b9c0", "contact_id": "6601a68fca35d8000718d42b", "voice_setting_id": null, "phone_call_outcome_id": "6095a710bd01d100a506d4c5", "phone_call_purpose_id": "6095a710bd01d100a506d4cd", "recording_url": null, "twilio_call_sid": null, "call_identifier": null, "agent_call_sid": null, "inbound": false, "from_number": null, "to_number": null, "start_time": "2025-06-23T19:50:57.292+00:00", "end_time": "2025-06-23T19:50:57.292+00:00", "transcription_too_long": null, "twilio_recording_sid": null, "need_recording_upload": true, "logged": true, "note": null, "status": "completed", "outreach_task_id": null, "salesforce_id": null, "hubspot_id": null, "conference_id": null, "opportunity_id": null, "voicemail_dropped": false, "parallel_dial_item_id": null, "transcribed": false, "transcribing": false, "transcription_progress": 0, "note_text": "", "contact": { "contact_roles": [], "id": "6601a68fca35d8000718d42b", "first_name": "Wesley", "last_name": "Tran", "name": "Wesley Tran", "linkedin_url": "http://www.linkedin.com/in/wesley-tran-5a9c3e74", "title": "Technical Support", "contact_stage_id": "6095a710bd01d100a506d4af", "owner_id": null, "creator_id": "60affe7d6e270a00f5db6fe4", "person_id": "66f0b509f10e970001a0b1b0", "email_needs_tickling": false, "organization_name": "Apollo.io", "source": "search", "original_source": "email_import", "organization_id": "5e66b6381e05b4008c8331b8", "headline": "Technical support", "photo_url": null, "present_raw_address": "Portland, Oregon, United States", "linkedin_uid": null, "extrapolated_email_confidence": null, "salesforce_id": null, "salesforce_lead_id": null, "salesforce_contact_id": null, "salesforce_account_id": null, "crm_owner_id": null, "created_at": "2024-03-25T16:30:07.555Z", "emailer_campaign_ids": [ "66a97236a8759801b5417678", "6567758e12b81a0264ab0bb1", "67be333b81ca47000d1cfb9f", "684b215edf80730019db612c" ], "direct_dial_status": "enrichment_failed", "direct_dial_enrichment_failed_at": "2025-02-27T15:16:57.036+00:00", "city": "Portland", "country": "United States", "state": "Oregon", "email_status": "verified", "email_source": "crm", "account_id": "6518c6184f20350001a0b9c0", "last_activity_date": "2025-06-23T19:50:57.000+00:00", "hubspot_vid": null, "hubspot_company_id": null, "crm_id": null, "sanitized_phone": "+14155550181", "merged_crm_ids": null, "updated_at": "2025-06-23T19:50:57.325Z", "queued_for_crm_push": false, "suggested_from_rule_engine_config_id": null, "email_unsubscribed": null, "person_deleted": null, "call_opted_out": null, "label_ids": [ "66a96f0cb2ef9801b486f3fd" ], "has_pending_email_arcgate_request": false, "has_email_arcgate_request": false, "existence_level": "full", "email": "wesley.t@example.com", "email_from_customer": null, "typed_custom_fields": { "677c0c4f451bfb02cf105e01": "Hi Justin,\n\nTechnical writing requires precision and insight. At Apollo.io, we understand the challenges of creating impactful documentation that stands out in a competitive landscape.\n\nOur platform helps technical writers like you gain visibility, track performance metrics, and showcase your expertise across professional networks, potentially elevating your professional profile.\n\nWould you be open to a 15-minute call to explore how we can support your professional growth and recognition?\n\nSunny" }, "custom_field_errors": null, "crm_record_url": null, "email_status_unavailable_reason": null, "email_true_status": "Verified", "updated_email_true_status": true, "source_display_name": "Requested from Apollo", "twitter_url": null, "facebook_url": null, "contact_emails": [ { "email_md5": "210b056db397b0a452dbd967d19f9cb5", "email_sha256": "a6ec970636a0a3c3fda95094cc2bb23a580ed900d7e96a517ad7694f657d8012", "email_status": "verified", "extrapolated_email_confidence": null, "position": 0, "email": "wesley.t@example.com", "free_domain": false, "source": "Apollo", "third_party_vendor_name": null, "vendor_validation_statuses": [], "email_needs_tickling": false, "email_true_status": "Verified", "email_status_unavailable_reason": null } ], "time_zone": "America/Los_Angeles", "show_intent": false, "phone_numbers": [ { "raw_number": "+1 555-555-0164", "sanitized_number": "+15555550164", "type": "work_hq", "position": 0, "status": "no_status", "dnc_status": null, "dnc_other_info": {}, "dialer_flags": null, "source_name": "Apollo", "vendor_validation_statuses": [], "third_party_vendor_name": null } ], "account_phone_note": null, "free_domain": false, "email_domain_catchall": false }, "account": { "raw_address": "535 mission st, san francisco, california, united states, 94105", "street_address": "535 Mission Street", "city": "San Francisco", "state": "California", "country": "United States", "postal_code": "94105", "id": "6518c6184f20350001a0b9c0", "domain": "apollo.io", "name": "Apollo.io", "team_id": "6095a710bd01d100a506d4ac", "organization_id": "5e66b6381e05b4008c8331b8", "account_stage_id": "6095a710bd01d100a506d4b9", "source": "job_change", "original_source": "job_change", "creator_id": "60affe7d6e270a00f5db6fe4", "owner_id": "66302798d03b9601c7934ec2", "created_at": "2023-10-01T01:06:32.057Z", "phone": "+1 415-555-0181", "phone_status": "no_status", "hubspot_id": null, "salesforce_id": "0017ntaJPTvuIbOUVM", "crm_owner_id": "005dK4PthD6owdyIkD", "parent_account_id": null, "linkedin_url": null, "sanitized_phone": "+15555550164", "account_playbook_statuses": [], "existence_level": "full", "label_ids": [ "6504905b21ba8e00a334eb0f" ], "typed_custom_fields": { "671932d76c03c402d0528199": [ "671932d76c03c402d0528195" ] }, "custom_field_errors": {}, "modality": "account", "source_display_name": "Job Change", "salesforce_record_url": "https://orgfarm-1a2b3c4d5e-dev-ed.develop.my.salesforce.com/0017ntaJPTvuIbOUVM", "crm_record_url": null, "twitter_url": null, "facebook_url": null, "show_intent": false, "organization_headcount_six_month_growth": null, "organization_headcount_twelve_month_growth": null, "organization_headcount_twenty_four_month_growth": null }, "duration": 45 }, "contact": { "contact_roles": [], "id": "6601a68fca35d8000718d42b", "first_name": "Wesley", "last_name": "Tran", "name": "Wesley Tran", "linkedin_url": "http://www.linkedin.com/in/wesley-tran-5a9c3e74", "title": "Technical Support", "contact_stage_id": "6095a710bd01d100a506d4af", "owner_id": null, "creator_id": "60affe7d6e270a00f5db6fe4", "person_id": "66f0b509f10e970001a0b1b0", "email_needs_tickling": false, "organization_name": "Apollo.io", "source": "search", "original_source": "email_import", "organization_id": "5e66b6381e05b4008c8331b8", "headline": "Technical support", "photo_url": null, "present_raw_address": "Portland, Oregon, United States", "linkedin_uid": null, "extrapolated_email_confidence": null, "salesforce_id": null, "salesforce_lead_id": null, "salesforce_contact_id": null, "salesforce_account_id": null, "crm_owner_id": null, "created_at": "2024-03-25T16:30:07.555Z", "emailer_campaign_ids": [ "66a97236a8759801b5417678", "6567758e12b81a0264ab0bb1", "67be333b81ca47000d1cfb9f", "684b215edf80730019db612c" ], "direct_dial_status": "enrichment_failed", "direct_dial_enrichment_failed_at": "2025-02-27T15:16:57.036+00:00", "city": "Portland", "country": "United States", "state": "Oregon", "email_status": "verified", "email_source": "crm", "account_id": "6518c6184f20350001a0b9c0", "last_activity_date": "2025-06-23T19:50:57.000+00:00", "hubspot_vid": null, "hubspot_company_id": null, "crm_id": null, "sanitized_phone": "+15555550164", "merged_crm_ids": null, "updated_at": "2025-06-23T19:50:57.325Z", "queued_for_crm_push": false, "suggested_from_rule_engine_config_id": null, "email_unsubscribed": null, "person_deleted": null, "call_opted_out": null, "label_ids": [ "66a96f0cb2ef9801b486f3fd" ], "has_pending_email_arcgate_request": false, "has_email_arcgate_request": false, "existence_level": "full", "email": "wesley.t@example.com", "email_from_customer": null, "typed_custom_fields": { "677c0c4f451bfb02cf105e01": "Hi Justin,\n\nTechnical writing requires precision and insight. At Apollo.io, we understand the challenges of creating impactful documentation that stands out in a competitive landscape.\n\nOur platform helps technical writers like you gain visibility, track performance metrics, and showcase your expertise across professional networks, potentially elevating your professional profile.\n\nWould you be open to a 15-minute call to explore how we can support your professional growth and recognition?\n\nSunny" }, "custom_field_errors": null, "crm_record_url": null, "email_status_unavailable_reason": null, "email_true_status": "Verified", "updated_email_true_status": true, "source_display_name": "Requested from Apollo", "twitter_url": null, "facebook_url": null, "contact_campaign_statuses": [ { "id": "66a977e82a86cb000139ceff", "emailer_campaign_id": "66a97236a8759801b5417678", "send_email_from_user_id": "66a3d80d4238fe02d2baaaaf", "inactive_reason": "replied", "status": "finished", "added_at": "2024-07-30T23:31:51.991+00:00", "added_by_user_id": "66a3d80d4238fe02d2baaaaf", "finished_at": "2024-10-08T16:51:24.185+00:00", "paused_at": null, "auto_unpause_at": null, "send_email_from_email_address": "priya.nadkarni@apollomail.io", "send_email_from_email_account_id": "66a423655825e8019ae89db6", "manually_set_unpause": null, "failure_reason": null, "current_step_id": "66a97236a8759801b541767d", "in_response_to_emailer_message_id": null, "cc_emails": null, "bcc_emails": null, "to_emails": null, "current_step_position": 3 }, { "id": "6708721db13a0a000190999c", "emailer_campaign_id": "6567758e12b81a0264ab0bb1", "send_email_from_user_id": "66a3d80d4238fe02d2baaaaf", "inactive_reason": "User deleted", "status": "failed", "added_at": "2024-10-11T00:32:29.857+00:00", "added_by_user_id": "60affe7d6e270a00f5db6fe4", "finished_at": null, "paused_at": null, "auto_unpause_at": null, "send_email_from_email_address": "priya.nadkarni@apollomail.io", "send_email_from_email_account_id": "66a423655825e8019ae89db6", "manually_set_unpause": null, "failure_reason": "user_deleted", "current_step_id": null, "in_response_to_emailer_message_id": null, "cc_emails": null, "bcc_emails": null, "to_emails": null, "current_step_position": null }, { "id": "680bd68fbfaec40015b9b32b", "emailer_campaign_id": "67be333b81ca47000d1cfb9f", "send_email_from_user_id": "66302798d03b9601c7934ebf", "inactive_reason": null, "status": "active", "added_at": "2025-04-25T18:38:07.090+00:00", "added_by_user_id": "66302798d03b9601c7934ebf", "finished_at": null, "paused_at": null, "auto_unpause_at": null, "send_email_from_email_address": "test.marcus.hale@apollomail.io", "send_email_from_email_account_id": "6633baaece5fbd01c791d7ca", "manually_set_unpause": null, "failure_reason": null, "current_step_id": "67be333b81ca47000d1cfba0", "in_response_to_emailer_message_id": null, "cc_emails": null, "bcc_emails": null, "to_emails": null, "current_step_position": 2 }, { "id": "684b21d0de0df60015d2218d", "emailer_campaign_id": "684b215edf80730019db612c", "send_email_from_user_id": "66302798d03b9601c7934ebf", "inactive_reason": "Completed last step", "status": "finished", "added_at": "2025-06-12T18:52:00.914+00:00", "added_by_user_id": "66302798d03b9601c7934ebf", "finished_at": "2025-06-12T21:34:16.705+00:00", "paused_at": null, "auto_unpause_at": null, "send_email_from_email_address": "test.marcus.hale@apollomail.io", "send_email_from_email_account_id": "6633baaece5fbd01c791d7ca", "manually_set_unpause": null, "failure_reason": "contact_stage_safeguard", "current_step_id": "684b216ec95a4f001d968d19", "in_response_to_emailer_message_id": null, "cc_emails": null, "bcc_emails": null, "to_emails": null, "current_step_position": 1 } ], "contact_emails": [ { "email_md5": "210b056db397b0a452dbd967d19f9cb5", "email_sha256": "a6ec970636a0a3c3fda95094cc2bb23a580ed900d7e96a517ad7694f657d8012", "email_status": "verified", "extrapolated_email_confidence": null, "position": 0, "email": "wesley.t@example.com", "free_domain": false, "source": "Apollo", "third_party_vendor_name": null, "vendor_validation_statuses": [], "email_needs_tickling": false, "email_true_status": "Verified", "email_status_unavailable_reason": null } ], "time_zone": "America/Los_Angeles", "show_intent": false, "phone_numbers": [ { "raw_number": "+1 555-555-0164", "sanitized_number": "+15555550164", "type": "work_hq", "position": 0, "status": "no_status", "dnc_status": null, "dnc_other_info": {}, "dialer_flags": null, "source_name": "Apollo", "vendor_validation_statuses": [], "third_party_vendor_name": null } ], "account_phone_note": null, "free_domain": false, "email_domain_catchall": false }, "team": { "id": "6095a710bd01d100a506d4ac", "phone_calls_finder_empty": false } } } } } } }, "401": { "description": "Unauthorized", "content": { "text/plain": { "examples": { "Check API Key": { "value": "Invalid API key. See https://docs.apollo.io/reference/authentication for how to authenticate.", "summary": "Check API Key" } } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "examples": { "Need Master API Key": { "value": "{\n \"error\": \"This API key is not authorized to access api/v1/usage_stats/api_usage_stats. Request an API key from your administrator that includes this endpoint in its configured scope.\",\n \"error_code\": \"API_INACCESSIBLE\"\n}", "summary": "Need Master API Key" } } } } } }, "parameters": [ { "name": "logged", "in": "query", "required": false, "description": "Set to `true` if you want to create an individual record for the phone call in Apollo.", "schema": { "type": "boolean", "default": "" } }, { "name": "user_id[]", "in": "query", "required": false, "description": "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`", "schema": { "type": "array", "default": "", "items": { "type": "string" } } }, { "name": "contact_id", "in": "query", "required": false, "description": "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`", "schema": { "type": "string", "default": "" } }, { "name": "account_id", "in": "query", "required": false, "description": "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`", "schema": { "type": "string", "default": "" } }, { "name": "to_number", "in": "query", "required": false, "description": "The phone number that you dialed.

Example: `5555550164`", "schema": { "type": "string", "default": "" } }, { "name": "from_number", "in": "query", "required": false, "description": "The phone number that dialed you.

Example: `5555550164`", "schema": { "type": "string", "default": "" } }, { "name": "status", "in": "query", "required": false, "description": "The status of the phone call. Possible values include: ", "schema": { "type": "string", "default": "" } }, { "name": "start_time", "in": "query", "required": false, "description": "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 specifying in hours and minutes how much you want to offset GMT.

Example: `2025-02-15T08:10:30Z`; `2025-03-25T10:15:30+05:00Z`", "schema": { "type": "string", "format": "date-time", "default": "" } }, { "name": "end_time", "in": "query", "required": false, "description": "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 an 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 specifying in hours and minutes how much you want to offset GMT.

Example: `2025-05-15T08:10:30Z`; `2025-05-25T10:15:30+05:00Z`", "schema": { "type": "string", "format": "date-time", "default": "" } }, { "name": "duration", "in": "query", "required": false, "description": "The duration of the call in seconds. Do not enter minutes.

Examples: `120`; `205`", "schema": { "type": "integer", "default": "" } }, { "name": "phone_call_purpose_id", "in": "query", "required": false, "description": "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`", "schema": { "type": "string", "default": "" } }, { "name": "phone_call_outcome_id", "in": "query", "required": false, "description": "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`", "schema": { "type": "string", "default": "" } }, { "name": "note", "in": "query", "required": false, "description": "Add a note to the call record.

Example: `This lead is interested in learning more about our new product line.`", "schema": { "type": "string", "default": "" } } ] } } }, "x-readme": { "headers": [ { "key": "Cache-Control", "value": "no-cache" }, { "key": "Content-Type", "value": "application/json" } ], "explorer-enabled": true, "proxy-enabled": true }, "x-readme-fauxas": true } ```