{ "item": [ { "id": "793f62dc-6606-4584-91c8-42d5311ba08a", "name": "Accounts", "description": { "content": "Create, update, and search the companies your team tracks in Apollo.", "type": "text/plain" }, "item": [ { "id": "91aaf12b-ccdb-4d35-812b-6b1e85fae9d6", "name": "Create an Account", "request": { "name": "Create an Account", "description": { "content": "## Endpoint essentials\n\n**API key access:** `api/v1/accounts/create` or `Master API key`\n\n**OAuth scopes:** `account_write`\n\n**Credit usage:** `0 credits` — [Learn more about API pricing and credits](https://docs.apollo.io/docs/api-pricing).\n\nAn account is a company saved in Apollo.

Use the Create an Account endpoint to add a new account to your team's Apollo account.

Apollo doesn't apply deduplication processes when you create a new account via the API. If your entry has the same name, domain, or other details as an existing account, Apollo creates a new account instead of updating the existing account. To update an existing account, use the Update an Account endpoint instead.", "type": "text/plain" }, "url": { "path": [ "accounts" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"domain\": \"\",\n \"owner_id\": \"\",\n \"account_stage_id\": \"\",\n \"phone\": \"\",\n \"raw_address\": \"\",\n \"typed_custom_fields\": {\n \"key_0\": \"\",\n \"key_1\": \"\",\n \"key_2\": \"\",\n \"key_3\": \"\",\n \"key_4\": \"\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "3cc8ab7c-8eb7-47b9-a479-d69f740ef6b1", "name": "200", "originalRequest": { "url": { "path": [ "accounts" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"domain\": \"\",\n \"owner_id\": \"\",\n \"account_stage_id\": \"\",\n \"phone\": \"\",\n \"raw_address\": \"\",\n \"typed_custom_fields\": {\n \"60c39ed82bd02f01154c470a\": \"2025-08-07\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"account\": {\n \"id\": \"66e9abf95ac32901b20d1a0d\",\n \"domain\": \"irishcopywriters.ie\",\n \"name\": \"The Irish Copywriters\",\n \"team_id\": \"6095a710bd01d100a506d4ac\",\n \"organization_id\": null,\n \"account_stage_id\": \"6095a710bd01d100a506d4b9\",\n \"source\": \"api\",\n \"original_source\": \"api\",\n \"creator_id\": null,\n \"owner_id\": \"66302798d03b9601c7934ebf\",\n \"created_at\": \"2024-09-17T16:19:05.663Z\",\n \"phone\": \"555-555-0108\",\n \"phone_status\": \"no_status\",\n \"hubspot_id\": null,\n \"salesforce_id\": null,\n \"crm_owner_id\": null,\n \"parent_account_id\": null,\n \"linkedin_url\": null,\n \"sanitized_phone\": \"+15555550108\",\n \"account_playbook_statuses\": [],\n \"account_rule_config_statuses\": [],\n \"existence_level\": \"full\",\n \"label_ids\": [],\n \"typed_custom_fields\": {\n \"60c39ed82bd02f01154c470a\": \"2025-08-07\"\n },\n \"custom_field_errors\": {},\n \"modality\": \"account\",\n \"source_display_name\": \"Created from API\",\n \"crm_record_url\": null,\n \"show_intent\": false,\n \"has_intent_signal_account\": false,\n \"intent_signal_account\": null\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b5a5340b-648a-4b73-aa2c-dec76a823d60", "name": "401", "originalRequest": { "url": { "path": [ "accounts" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "text/plain" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"domain\": \"\",\n \"owner_id\": \"\",\n \"account_stage_id\": \"\",\n \"phone\": \"\",\n \"raw_address\": \"\",\n \"typed_custom_fields\": {\n \"60c39ed82bd02f01154c470a\": \"2025-08-07\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "Invalid API key. See https://docs.apollo.io/reference/authentication for how to authenticate.", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "9ca3917f-d854-4d81-b02e-ceee1af24363", "name": "403", "originalRequest": { "url": { "path": [ "accounts" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"domain\": \"\",\n \"owner_id\": \"\",\n \"account_stage_id\": \"\",\n \"phone\": \"\",\n \"raw_address\": \"\",\n \"typed_custom_fields\": {\n \"60c39ed82bd02f01154c470a\": \"2025-08-07\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "\"{\\n \\\"error\\\": \\\"This API key is not authorized to access api/v1/accounts/create. Request an API key from your administrator that includes this endpoint in its configured scope.\\\",\\n \\\"error_code\\\": \\\"API_INACCESSIBLE\\\"\\n}\"", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3056b9e2-63fa-4c83-b0b6-14931e184f7d", "name": "422", "originalRequest": { "url": { "path": [ "accounts" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"domain\": \"\",\n \"owner_id\": \"\",\n \"account_stage_id\": \"\",\n \"phone\": \"\",\n \"raw_address\": \"\",\n \"typed_custom_fields\": {\n \"60c39ed82bd02f01154c470a\": \"2025-08-07\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "\"{\\n \\\"error\\\": \\\"Please specify at least a name or domain.\\\"\\n}\"", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "10ef4afb-b0b1-4585-8655-01a1a4988d52", "name": "429", "originalRequest": { "url": { "path": [ "accounts" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"domain\": \"\",\n \"owner_id\": \"\",\n \"account_stage_id\": \"\",\n \"phone\": \"\",\n \"raw_address\": \"\",\n \"typed_custom_fields\": {\n \"60c39ed82bd02f01154c470a\": \"2025-08-07\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "\"{\\n \\\"message\\\": \\\"The maximum number of api calls allowed for api/v1/accounts is 600 times per hour. Please upgrade your plan from https://app.apollo.io/#/settings/plans/upgrade.\\\"\\n}\"", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "ced2084d-1d1c-4fcc-880c-be95e07d9c74", "name": "Update an Account", "request": { "name": "Update an Account", "description": { "content": "## Endpoint essentials\n\n**API key access:** `api/v1/accounts/update` or `Master API key`\n\n**OAuth scopes:** `account_update`\n\n**Credit usage:** `0 credits` — [Learn more about API pricing and credits](https://docs.apollo.io/docs/api-pricing).\n\n An account is a company saved in Apollo.

Use the Update an Account endpoint to update existing accounts in your team's Apollo account.

To create a new account, use the Create an Account endpoint instead. To update the account stage for multiple accounts, use the Bulk Update Accounts endpoint.", "type": "text/plain" }, "url": { "path": [ "accounts", ":account_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "account_id", "description": "(Required) The Apollo ID for the account that you want to update.

To find account IDs, call the Search for Accounts endpoint and identify the `id` value for the contact.

Example: `66e9abf95ac32901b20d1a0d`" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "auth": null, "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"domain\": \"\",\n \"owner_id\": \"\",\n \"account_stage_id\": \"\",\n \"raw_address\": \"\",\n \"phone\": \"\",\n \"typed_custom_fields\": {\n \"key_0\": \"\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "dd5d8fc8-cc59-4342-a76d-2623070f021a", "name": "200", "originalRequest": { "url": { "path": [ "accounts", ":account_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "account_id", "description": "(Required) The Apollo ID for the account that you want to update.

To find account IDs, call the Search for Accounts endpoint and identify the `id` value for the contact.

Example: `66e9abf95ac32901b20d1a0d`" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"domain\": \"\",\n \"owner_id\": \"\",\n \"account_stage_id\": \"\",\n \"raw_address\": \"\",\n \"phone\": \"\",\n \"typed_custom_fields\": {\n \"60c39ed82bd02f01154c470a\": \"2025-08-07\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"account\": {\n \"id\": \"66e9abf95ac32901b20d1a0d\",\n \"domain\": \"irishcopywriters.com\",\n \"name\": \"The Fast Irish Copywriters\",\n \"team_id\": \"6095a710bd01d100a506d4ac\",\n \"organization_id\": null,\n \"account_stage_id\": \"61b8e913e0f4d2012e3af74e\",\n \"source\": \"api\",\n \"original_source\": \"api\",\n \"creator_id\": null,\n \"owner_id\": \"66302798d03b9601c7934ebf\",\n \"created_at\": \"2024-09-17T16:19:05.663Z\",\n \"phone\": \"555-555-0172\",\n \"phone_status\": \"no_status\",\n \"hubspot_id\": null,\n \"salesforce_id\": null,\n \"crm_owner_id\": null,\n \"parent_account_id\": null,\n \"linkedin_url\": null,\n \"sanitized_phone\": \"+15555550172\",\n \"account_playbook_statuses\": [],\n \"account_rule_config_statuses\": [],\n \"existence_level\": \"full\",\n \"label_ids\": [],\n \"custom_field_errors\": {},\n \"modality\": \"account\",\n \"source_display_name\": \"Created from API\",\n \"crm_record_url\": null,\n \"show_intent\": false,\n \"has_intent_signal_account\": false,\n \"intent_signal_account\": null,\n \"typed_custom_fields\": {\n \"60c39ed82bd02f01154c470a\": \"2025-08-07\"\n }\n },\n \"labels\": []\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8f49480c-a655-428d-93b7-f59cc846664e", "name": "401", "originalRequest": { "url": { "path": [ "accounts", ":account_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "account_id", "description": "(Required) The Apollo ID for the account that you want to update.

To find account IDs, call the Search for Accounts endpoint and identify the `id` value for the contact.

Example: `66e9abf95ac32901b20d1a0d`" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "text/plain" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"domain\": \"\",\n \"owner_id\": \"\",\n \"account_stage_id\": \"\",\n \"raw_address\": \"\",\n \"phone\": \"\",\n \"typed_custom_fields\": {\n \"60c39ed82bd02f01154c470a\": \"2025-08-07\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "Invalid API key. See https://docs.apollo.io/reference/authentication for how to authenticate.", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "497324d0-4310-4a29-86a5-d24418b34ec0", "name": "403", "originalRequest": { "url": { "path": [ "accounts", ":account_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "account_id", "description": "(Required) The Apollo ID for the account that you want to update.

To find account IDs, call the Search for Accounts endpoint and identify the `id` value for the contact.

Example: `66e9abf95ac32901b20d1a0d`" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"domain\": \"\",\n \"owner_id\": \"\",\n \"account_stage_id\": \"\",\n \"raw_address\": \"\",\n \"phone\": \"\",\n \"typed_custom_fields\": {\n \"60c39ed82bd02f01154c470a\": \"2025-08-07\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "\"{\\n \\\"error\\\": \\\"This API key is not authorized to access api/v1/accounts/update. Request an API key from your administrator that includes this endpoint in its configured scope.\\\",\\n \\\"error_code\\\": \\\"API_INACCESSIBLE\\\"\\n}\"", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fe2bd393-0248-4b94-a173-ba3050e6c110", "name": "422", "originalRequest": { "url": { "path": [ "accounts", ":account_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "account_id", "description": "(Required) The Apollo ID for the account that you want to update.

To find account IDs, call the Search for Accounts endpoint and identify the `id` value for the contact.

Example: `66e9abf95ac32901b20d1a0d`" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"domain\": \"\",\n \"owner_id\": \"\",\n \"account_stage_id\": \"\",\n \"raw_address\": \"\",\n \"phone\": \"\",\n \"typed_custom_fields\": {\n \"60c39ed82bd02f01154c470a\": \"2025-08-07\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "\"{\\n \\\"error\\\": \\\"Parameters misconfigured. account_id is not a valid ID\\\"\\n}\"", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2bd0e164-b5ce-4cf7-b5b3-a3145d68072d", "name": "429", "originalRequest": { "url": { "path": [ "accounts", ":account_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "account_id", "description": "(Required) The Apollo ID for the account that you want to update.

To find account IDs, call the Search for Accounts endpoint and identify the `id` value for the contact.

Example: `66e9abf95ac32901b20d1a0d`" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"domain\": \"\",\n \"owner_id\": \"\",\n \"account_stage_id\": \"\",\n \"raw_address\": \"\",\n \"phone\": \"\",\n \"typed_custom_fields\": {\n \"60c39ed82bd02f01154c470a\": \"2025-08-07\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "\"{\\n \\\"message\\\": \\\"The maximum number of api calls allowed for api/v1/accounts/{account_id} is 600 times per hour. Please upgrade your plan from https://app.apollo.io/#/settings/plans/upgrade.\\\"\\n}\"", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "ebe08383-5c51-4de5-a415-479164e1864c", "name": "Search for Accounts", "request": { "name": "Search for Accounts", "description": { "content": "## Endpoint essentials\n\n**API key access:** `api/v1/accounts/search` or `Master API key`\n\n**OAuth scopes:** `accounts_search`\n\n**Credit usage:** `0 credits` — [Learn more about API pricing and credits](https://docs.apollo.io/docs/api-pricing).\n\n An account is a company saved in Apollo.

Use the Search for Accounts endpoint to search for an account that has been saved to Apollo.

This endpoint only returns accounts in the search results. To search for companies in Apollo, call the Organization Search endpoint.

To protect Apollo's performance for all users, this endpoint has a display limit of 50,000 records (100 records per page, up to 500 pages). Add more filters to narrow your search results as much as possible.", "type": "text/plain" }, "url": { "path": [ "accounts", "search" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"q_organization_name\": \"\",\n \"account_stage_ids\": [\n \"\",\n \"\"\n ],\n \"account_label_ids\": [\n \"\",\n \"\"\n ],\n \"sort_by_field\": \"\",\n \"sort_ascending\": false,\n \"page\": \"\",\n \"per_page\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "11739800-d4a8-404e-afba-885cccbf6dcd", "name": "200", "originalRequest": { "url": { "path": [ "accounts", "search" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"q_organization_name\": \"\",\n \"account_stage_ids\": [\n \"\",\n \"\"\n ],\n \"account_label_ids\": [\n \"\",\n \"\"\n ],\n \"sort_by_field\": \"\",\n \"sort_ascending\": false,\n \"page\": \"\",\n \"per_page\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"breadcrumbs\": [\n {\n \"label\": \"Company Name\",\n \"signal_field_name\": \"q_organization_name\",\n \"value\": \"Irish Copywriters\",\n \"display_name\": \"Irish Copywriters\"\n },\n {\n \"label\": \"Account Stage\",\n \"signal_field_name\": \"account_stage_ids\",\n \"value\": \"61b8e913e0f4d2012e3af74e\",\n \"display_name\": \"Lead\"\n }\n ],\n \"partial_results_only\": false,\n \"has_join\": false,\n \"disable_eu_prospecting\": false,\n \"partial_results_limit\": 10000,\n \"pagination\": {\n \"page\": 1,\n \"per_page\": 5,\n \"total_entries\": 1,\n \"total_pages\": 1\n },\n \"accounts\": [\n {\n \"id\": \"66e9abf95ac32901b20d1a0d\",\n \"domain\": \"irishcopywriters.com\",\n \"name\": \"The Fast Irish Copywriters\",\n \"team_id\": \"6095a710bd01d100a506d4ac\",\n \"organization_id\": null,\n \"account_stage_id\": \"61b8e913e0f4d2012e3af74e\",\n \"label_ids\": [\n \"68eec47ece3b0b000de4751f\"\n ],\n \"source\": \"api\",\n \"original_source\": \"api\",\n \"creator_id\": null,\n \"owner_id\": \"66302798d03b9601c7934ebf\",\n \"created_at\": \"2024-09-17T16:19:05.663Z\",\n \"phone\": \"555-555-0172\",\n \"phone_status\": \"no_status\",\n \"hubspot_id\": null,\n \"salesforce_id\": null,\n \"crm_owner_id\": null,\n \"parent_account_id\": null,\n \"linkedin_url\": null,\n \"sanitized_phone\": \"+15555550172\",\n \"account_playbook_statuses\": [],\n \"account_rule_config_statuses\": [],\n \"existence_level\": \"full\",\n \"typed_custom_fields\": {},\n \"custom_field_errors\": {},\n \"modality\": \"account\",\n \"source_display_name\": \"Created from API\",\n \"crm_record_url\": null,\n \"contact_emailer_campaign_ids\": [],\n \"contact_campaign_status_tally\": {},\n \"num_contacts\": 0,\n \"last_activity_date\": null,\n \"show_intent\": false,\n \"has_intent_signal_account\": false,\n \"intent_signal_account\": null\n }\n ],\n \"num_fetch_result\": null\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "18408f15-0854-4953-9065-e3f84010f08b", "name": "401", "originalRequest": { "url": { "path": [ "accounts", "search" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "text/plain" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"q_organization_name\": \"\",\n \"account_stage_ids\": [\n \"\",\n \"\"\n ],\n \"account_label_ids\": [\n \"\",\n \"\"\n ],\n \"sort_by_field\": \"\",\n \"sort_ascending\": false,\n \"page\": \"\",\n \"per_page\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "Invalid API key. See https://docs.apollo.io/reference/authentication for how to authenticate.", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "42977ff6-60ba-43bb-a2c5-665e168af2f8", "name": "403", "originalRequest": { "url": { "path": [ "accounts", "search" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"q_organization_name\": \"\",\n \"account_stage_ids\": [\n \"\",\n \"\"\n ],\n \"account_label_ids\": [\n \"\",\n \"\"\n ],\n \"sort_by_field\": \"\",\n \"sort_ascending\": false,\n \"page\": \"\",\n \"per_page\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "\"{\\n \\\"message\\\": \\\"This endpoint is only available to Apollo users on paid plans.\\\"\\n}\"", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "65ddd1ce-805c-43c7-83e3-f8d04410e2f8", "name": "422", "originalRequest": { "url": { "path": [ "accounts", "search" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"q_organization_name\": \"\",\n \"account_stage_ids\": [\n \"\",\n \"\"\n ],\n \"account_label_ids\": [\n \"\",\n \"\"\n ],\n \"sort_by_field\": \"\",\n \"sort_ascending\": false,\n \"page\": \"\",\n \"per_page\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "\"{\\n \\\"error\\\": \\\"Invalid sort criteria\\\",\\n \\\"skip_alert_dialog\\\": true\\n}\"", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e019e564-17b5-4589-a0f5-707309adf0b6", "name": "429", "originalRequest": { "url": { "path": [ "accounts", "search" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"q_organization_name\": \"\",\n \"account_stage_ids\": [\n \"\",\n \"\"\n ],\n \"account_label_ids\": [\n \"\",\n \"\"\n ],\n \"sort_by_field\": \"\",\n \"sort_ascending\": false,\n \"page\": \"\",\n \"per_page\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "\"{\\n \\\"message\\\": \\\"The maximum number of api calls allowed for api/v1/accounts/search is 600 times per hour. Please upgrade your plan from https://app.apollo.io/#/settings/plans/upgrade.\\\"\\n}\"", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c5dfc744-e1fb-4b48-b996-578909997dfa", "name": "Bulk Create Accounts", "request": { "name": "Bulk Create Accounts", "description": { "content": "## Endpoint essentials\n\n**API key access:** `api/v1/accounts/bulk_create` or `Master API key`\n\n**OAuth scopes:** `account_bulk_create`\n\n**Credit usage:** `0 credits` — [Learn more about API pricing and credits](https://docs.apollo.io/docs/api-pricing).\n\nAn account is a company saved in Apollo.

Use the bulk create accounts endpoint to create up to one hundred accounts in a single API request. This endpoint supports intelligent deduplication and returns separate arrays for newly created and existing accounts.

**Important**: This endpoint creates new accounts but doesn't update existing ones. Existing accounts that match the criteria are returned in the existing_accounts array without modification.

To update existing accounts, use the Bulk Update Accounts endpoint.", "type": "text/plain" }, "url": { "path": [ "accounts", "bulk_create" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"accounts\": [\n {\n \"name\": \"\",\n \"domain\": \"\",\n \"owner_id\": \"\",\n \"phone\": \"\",\n \"phone_status_cd\": \"\",\n \"raw_address\": \"\",\n \"linkedin_url\": \"\",\n \"facebook_url\": \"\",\n \"twitter_url\": \"\",\n \"salesforce_id\": \"\",\n \"hubspot_id\": \"\",\n \"merged_crm_ids\": [\n \"\",\n \"\"\n ],\n \"organization_id\": \"\",\n \"parent_account_id\": \"\",\n \"account_stage_id\": \"\",\n \"typed_custom_fields\": {\n \"key_0\": \"\"\n }\n },\n {\n \"name\": \"\",\n \"domain\": \"\",\n \"owner_id\": \"\",\n \"phone\": \"\",\n \"phone_status_cd\": \"\",\n \"raw_address\": \"\",\n \"linkedin_url\": \"\",\n \"facebook_url\": \"\",\n \"twitter_url\": \"\",\n \"salesforce_id\": \"\",\n \"hubspot_id\": \"\",\n \"merged_crm_ids\": [\n \"\",\n \"\"\n ],\n \"organization_id\": \"\",\n \"parent_account_id\": \"\",\n \"account_stage_id\": \"\",\n \"typed_custom_fields\": {\n \"key_0\": \"\",\n \"key_1\": \"\",\n \"key_2\": \"\"\n }\n }\n ],\n \"append_label_names\": [\n \"\",\n \"\"\n ],\n \"run_dedupe\": false\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "8780d8d3-c669-4c12-a4fe-3a27b852e21d", "name": "200 - Successful bulk create operation", "originalRequest": { "url": { "path": [ "accounts", "bulk_create" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"accounts\": [\n {\n \"name\": \"Acme Corporation\",\n \"domain\": \"acme.com\",\n \"phone\": \"+1-555-0135\"\n },\n {\n \"name\": \"TechStart Inc\",\n \"domain\": \"example.com\",\n \"linkedin_url\": \"https://linkedin.com/company/techstart\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"created_accounts\": [\n {\n \"id\": \"507f1f77bcf86cd799439011\",\n \"name\": \"Acme Corporation\",\n \"domain\": \"acme.com\",\n \"team_id\": \"507f1f77bcf86cd799439012\",\n \"owner_id\": \"507f1f77bcf86cd799439013\",\n \"account_stage_id\": \"507f1f77bcf86cd799439014\",\n \"phone\": \"+1-555-0135\",\n \"created_at\": \"2025-10-16T18:30:00Z\",\n \"updated_at\": \"2025-10-16T18:30:00Z\"\n },\n {\n \"id\": \"507f1f77bcf86cd799439017\",\n \"name\": \"TechStart Inc\",\n \"domain\": \"example.com\",\n \"team_id\": \"507f1f77bcf86cd799439012\",\n \"owner_id\": \"507f1f77bcf86cd799439013\",\n \"linkedin_url\": \"https://linkedin.com/company/techstart\",\n \"created_at\": \"2025-10-16T18:30:00Z\",\n \"updated_at\": \"2025-10-16T18:30:00Z\"\n }\n ],\n \"existing_accounts\": [\n {\n \"id\": \"507f1f77bcf86cd799439015\",\n \"name\": \"Original Company Name\",\n \"domain\": \"existing.com\",\n \"team_id\": \"507f1f77bcf86cd799439012\",\n \"owner_id\": \"507f1f77bcf86cd799439013\",\n \"created_at\": \"2025-09-01T10:00:00Z\",\n \"updated_at\": \"2025-09-15T14:30:00Z\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7459fbad-b245-4e86-afa1-fda760919a57", "name": "401 - Unauthorized", "originalRequest": { "url": { "path": [ "accounts", "bulk_create" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "text/plain" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"accounts\": [\n {\n \"name\": \"Acme Corporation\",\n \"domain\": \"acme.com\",\n \"phone\": \"+1-555-0135\"\n },\n {\n \"name\": \"TechStart Inc\",\n \"domain\": \"example.com\",\n \"linkedin_url\": \"https://linkedin.com/company/techstart\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "Invalid API key. See https://docs.apollo.io/reference/authentication for how to authenticate.", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "103f087d-7a73-4070-8cd9-c0f9280691b2", "name": "422 - Unprocessable Entity", "originalRequest": { "url": { "path": [ "accounts", "bulk_create" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"accounts\": [\n {\n \"name\": \"Acme Corporation\",\n \"domain\": \"acme.com\",\n \"phone\": \"+1-555-0135\"\n },\n {\n \"name\": \"TechStart Inc\",\n \"domain\": \"example.com\",\n \"linkedin_url\": \"https://linkedin.com/company/techstart\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "\"{\\n \\\"error\\\": \\\"Please provide an array of account attributes in the \\\\\\\"accounts\\\\\\\" parameter.\\\"\\n}\"", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "515a2359-7f65-45e8-b9a1-a41a968e9514", "name": "429 - Too Many Requests", "originalRequest": { "url": { "path": [ "accounts", "bulk_create" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"accounts\": [\n {\n \"name\": \"Acme Corporation\",\n \"domain\": \"acme.com\",\n \"phone\": \"+1-555-0135\"\n },\n {\n \"name\": \"TechStart Inc\",\n \"domain\": \"example.com\",\n \"linkedin_url\": \"https://linkedin.com/company/techstart\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "\"{\\n \\\"message\\\": \\\"The maximum number of api calls allowed for api/v1/accounts/bulk_create is 600 times per hour. Please upgrade your plan from https://app.apollo.io/#/settings/plans/upgrade.\\\"\\n}\"", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b1a42462-0070-47a2-971f-d3ddd1b82563", "name": "500 - Internal Server Error", "originalRequest": { "url": { "path": [ "accounts", "bulk_create" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"accounts\": [\n {\n \"name\": \"Acme Corporation\",\n \"domain\": \"acme.com\",\n \"phone\": \"+1-555-0135\"\n },\n {\n \"name\": \"TechStart Inc\",\n \"domain\": \"example.com\",\n \"linkedin_url\": \"https://linkedin.com/company/techstart\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "\"{\\n \\\"error\\\": \\\"An error occurred while creating accounts. Please try again.\\\"\\n}\"", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "17803cde-c820-415e-a7ed-c248fba48738", "name": "Bulk Update Accounts", "request": { "name": "Bulk Update Accounts", "description": { "content": "## Endpoint essentials\n\n**API key access:** `api/v1/accounts/bulk_update` or `Master API key`\n\n**OAuth scopes:** `account_stages_update`\n\n**Credit usage:** `0 credits` — [Learn more about API pricing and credits](https://docs.apollo.io/docs/api-pricing).\n\nAn account is a company saved in Apollo.

Use the Bulk Update Accounts endpoint to simultaneously update multiple accounts in your team's Apollo account.

This endpoint allows you to update common fields across multiple accounts efficiently, such as account stages, owners, names, and custom fields.

You can update up to 1,000 accounts per request.

Important: Asynchronous processing (async parameter) is only supported when using account_ids to apply the same updates to all accounts. If you use async with account_attributes (individual updates per account), the request fails with a 422 error.", "type": "text/plain" }, "url": { "path": [ "accounts", "bulk_update" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"account_ids\": [\n \"\",\n \"\"\n ],\n \"account_attributes\": [\n {\n \"id\": \"\",\n \"name\": \"\",\n \"owner_id\": \"\",\n \"account_stage_id\": \"\",\n \"typed_custom_fields\": {\n \"key_0\": \"\"\n }\n },\n {\n \"id\": \"\",\n \"name\": \"\",\n \"owner_id\": \"\",\n \"account_stage_id\": \"\",\n \"typed_custom_fields\": {\n \"key_0\": \"\",\n \"key_1\": \"\",\n \"key_2\": \"\"\n }\n }\n ],\n \"name\": \"\",\n \"owner_id\": \"\",\n \"account_stage_id\": \"\",\n \"async\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "2031a331-bb8b-44c6-a664-0759fdc2c1c0", "name": "200", "originalRequest": { "url": { "path": [ "accounts", "bulk_update" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"account_ids\": [\n \"66e9abf95ac32901b20d1a0d\",\n \"66e9a4db056fe802d331fb8a\"\n ],\n \"account_attributes\": [\n {\n \"id\": \"66e9abf95ac32901b20d1a0d\",\n \"name\": \"Acme Corporation\",\n \"owner_id\": \"66302798d03b9601c7934ebf\",\n \"account_stage_id\": \"6095a710bd01d100a506d4b7\",\n \"typed_custom_fields\": {\n \"60c39ed82bd02f01154c470a\": \"2025-08-07\"\n }\n },\n {\n \"id\": \"66e9abf95ac32901b20d1a0d\",\n \"name\": \"Acme Corporation\",\n \"owner_id\": \"66302798d03b9601c7934ebf\",\n \"account_stage_id\": \"6095a710bd01d100a506d4b7\",\n \"typed_custom_fields\": {\n \"60c39ed82bd02f01154c470a\": \"2025-08-07\"\n }\n }\n ],\n \"name\": \"Updated Account Name\",\n \"owner_id\": \"66302798d03b9601c7934ebf\",\n \"account_stage_id\": \"6095a710bd01d100a506d4b7\",\n \"async\": false\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "\"{\\n \\\"accounts\\\": [\\n {\\n \\\"id\\\": \\\"66e9abf95ac32901b20d1a0d\\\",\\n \\\"account_stage_id\\\": \\\"6095a710bd01d100a506d4b7\\\"\\n },\\n {\\n \\\"id\\\": \\\"66e9a4db056fe802d331fb8a\\\",\\n \\\"account_stage_id\\\": \\\"6095a710bd01d100a506d4b7\\\"\\n },\\n {\\n \\\"id\\\": \\\"66e9a7866e440201b42ac31d\\\",\\n \\\"account_stage_id\\\": \\\"6095a710bd01d100a506d4b7\\\"\\n }\\n ]\\n}\"", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6197f4ed-2756-49e3-9e81-856fb29e4742", "name": "401", "originalRequest": { "url": { "path": [ "accounts", "bulk_update" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "text/plain" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"account_ids\": [\n \"66e9abf95ac32901b20d1a0d\",\n \"66e9a4db056fe802d331fb8a\"\n ],\n \"account_attributes\": [\n {\n \"id\": \"66e9abf95ac32901b20d1a0d\",\n \"name\": \"Acme Corporation\",\n \"owner_id\": \"66302798d03b9601c7934ebf\",\n \"account_stage_id\": \"6095a710bd01d100a506d4b7\",\n \"typed_custom_fields\": {\n \"60c39ed82bd02f01154c470a\": \"2025-08-07\"\n }\n },\n {\n \"id\": \"66e9abf95ac32901b20d1a0d\",\n \"name\": \"Acme Corporation\",\n \"owner_id\": \"66302798d03b9601c7934ebf\",\n \"account_stage_id\": \"6095a710bd01d100a506d4b7\",\n \"typed_custom_fields\": {\n \"60c39ed82bd02f01154c470a\": \"2025-08-07\"\n }\n }\n ],\n \"name\": \"Updated Account Name\",\n \"owner_id\": \"66302798d03b9601c7934ebf\",\n \"account_stage_id\": \"6095a710bd01d100a506d4b7\",\n \"async\": false\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "Invalid API key. See https://docs.apollo.io/reference/authentication for how to authenticate.", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "7f4eb358-17e1-414c-8159-28949fbbae46", "name": "403", "originalRequest": { "url": { "path": [ "accounts", "bulk_update" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"account_ids\": [\n \"66e9abf95ac32901b20d1a0d\",\n \"66e9a4db056fe802d331fb8a\"\n ],\n \"account_attributes\": [\n {\n \"id\": \"66e9abf95ac32901b20d1a0d\",\n \"name\": \"Acme Corporation\",\n \"owner_id\": \"66302798d03b9601c7934ebf\",\n \"account_stage_id\": \"6095a710bd01d100a506d4b7\",\n \"typed_custom_fields\": {\n \"60c39ed82bd02f01154c470a\": \"2025-08-07\"\n }\n },\n {\n \"id\": \"66e9abf95ac32901b20d1a0d\",\n \"name\": \"Acme Corporation\",\n \"owner_id\": \"66302798d03b9601c7934ebf\",\n \"account_stage_id\": \"6095a710bd01d100a506d4b7\",\n \"typed_custom_fields\": {\n \"60c39ed82bd02f01154c470a\": \"2025-08-07\"\n }\n }\n ],\n \"name\": \"Updated Account Name\",\n \"owner_id\": \"66302798d03b9601c7934ebf\",\n \"account_stage_id\": \"6095a710bd01d100a506d4b7\",\n \"async\": false\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "\"{\\n \\\"error\\\": \\\"This API key is not authorized to access api/v1/accounts/bulk_update. Request an API key from your administrator that includes this endpoint in its configured scope.\\\",\\n \\\"error_code\\\": \\\"API_INACCESSIBLE\\\"\\n}\"", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "afde7d8f-4837-4e1c-8663-96d30fa81188", "name": "422", "originalRequest": { "url": { "path": [ "accounts", "bulk_update" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"account_ids\": [\n \"66e9abf95ac32901b20d1a0d\",\n \"66e9a4db056fe802d331fb8a\"\n ],\n \"account_attributes\": [\n {\n \"id\": \"66e9abf95ac32901b20d1a0d\",\n \"name\": \"Acme Corporation\",\n \"owner_id\": \"66302798d03b9601c7934ebf\",\n \"account_stage_id\": \"6095a710bd01d100a506d4b7\",\n \"typed_custom_fields\": {\n \"60c39ed82bd02f01154c470a\": \"2025-08-07\"\n }\n },\n {\n \"id\": \"66e9abf95ac32901b20d1a0d\",\n \"name\": \"Acme Corporation\",\n \"owner_id\": \"66302798d03b9601c7934ebf\",\n \"account_stage_id\": \"6095a710bd01d100a506d4b7\",\n \"typed_custom_fields\": {\n \"60c39ed82bd02f01154c470a\": \"2025-08-07\"\n }\n }\n ],\n \"name\": \"Updated Account Name\",\n \"owner_id\": \"66302798d03b9601c7934ebf\",\n \"account_stage_id\": \"6095a710bd01d100a506d4b7\",\n \"async\": false\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "\"{\\n \\\"error\\\": \\\"Async processing is not permitted.\\\"\\n}\"", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3f4dbb7d-6a6f-4ca1-861f-ad2412ab062e", "name": "429", "originalRequest": { "url": { "path": [ "accounts", "bulk_update" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"account_ids\": [\n \"66e9abf95ac32901b20d1a0d\",\n \"66e9a4db056fe802d331fb8a\"\n ],\n \"account_attributes\": [\n {\n \"id\": \"66e9abf95ac32901b20d1a0d\",\n \"name\": \"Acme Corporation\",\n \"owner_id\": \"66302798d03b9601c7934ebf\",\n \"account_stage_id\": \"6095a710bd01d100a506d4b7\",\n \"typed_custom_fields\": {\n \"60c39ed82bd02f01154c470a\": \"2025-08-07\"\n }\n },\n {\n \"id\": \"66e9abf95ac32901b20d1a0d\",\n \"name\": \"Acme Corporation\",\n \"owner_id\": \"66302798d03b9601c7934ebf\",\n \"account_stage_id\": \"6095a710bd01d100a506d4b7\",\n \"typed_custom_fields\": {\n \"60c39ed82bd02f01154c470a\": \"2025-08-07\"\n }\n }\n ],\n \"name\": \"Updated Account Name\",\n \"owner_id\": \"66302798d03b9601c7934ebf\",\n \"account_stage_id\": \"6095a710bd01d100a506d4b7\",\n \"async\": false\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "\"{\\n \\\"message\\\": \\\"The maximum number of api calls allowed for api/v1/accounts/bulk_update is 600 times per hour. Please upgrade your plan from https://app.apollo.io/#/settings/plans/upgrade.\\\"\\n}\"", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "91070200-861e-4c6b-9d05-f64315e3180f", "name": "Update Account Owner for Multiple Accounts", "request": { "name": "Update Account Owner for Multiple Accounts", "description": { "content": "## Endpoint essentials\n\n**API key access:** `api/v1/accounts/update_owners` or `Master API key`\n\n**OAuth scopes:** `account_owners_update`\n\n**Credit usage:** `0 credits` — [Learn more about API pricing and credits](https://docs.apollo.io/docs/api-pricing).\n\nAccount owners manage saved accounts in Apollo.

Use the Update Account Owner for Multiple Accounts endpoint to assign multiple accounts to a different user in your team's Apollo account.

To update more than the account owner, such as domains or phone numbers, use the Update an Account endpoint instead.", "type": "text/plain" }, "url": { "path": [ "accounts", "update_owners" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "account_ids[]", "value": "", "description": "(Required) The Apollo IDs for the account that you want to assign to an owner.

To find account IDs, call the Search for Accounts endpoint and identify the `id` value for the account.

Example: `66e9abf95ac32901b20d1a0d`" }, { "disabled": false, "key": "account_ids[]", "value": "", "description": "(Required) The Apollo IDs for the account that you want to assign to an owner.

To find account IDs, call the Search for Accounts endpoint and identify the `id` value for the account.

Example: `66e9abf95ac32901b20d1a0d`" }, { "disabled": false, "key": "owner_id", "value": "", "description": "(Required) The ID for the account owner within your team's Apollo account. This user will be assigned ownership of the accounts.

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

Example: `66302798d03b9601c7934ebf`" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": null }, "response": [ { "id": "7aa5243c-68c3-40bb-978f-c700a851ef3e", "name": "200", "originalRequest": { "url": { "path": [ "accounts", "update_owners" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "account_ids[]", "value": "" }, { "key": "account_ids[]", "value": "" }, { "key": "owner_id", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"accounts\": [\n {\n \"id\": \"66e9a4db056fe802d331fb8a\",\n \"owner_id\": \"66302798d03b9601c7934ebf\",\n \"crm_owner_id\": null\n },\n {\n \"id\": \"66e9abf95ac32901b20d1a0d\",\n \"owner_id\": \"66302798d03b9601c7934ebf\",\n \"crm_owner_id\": null\n },\n {\n \"id\": \"66e9a7866e440201b42ac31d\",\n \"owner_id\": \"66302798d03b9601c7934ebf\",\n \"crm_owner_id\": null\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e8ada662-029d-4c51-bb07-e97061ea72e9", "name": "401", "originalRequest": { "url": { "path": [ "accounts", "update_owners" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "account_ids[]", "value": "" }, { "key": "account_ids[]", "value": "" }, { "key": "owner_id", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "text/plain" } ], "method": "POST", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "Invalid API key. See https://docs.apollo.io/reference/authentication for how to authenticate.", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "032aaa5c-32b9-4707-b10e-23bc00f66e5f", "name": "403", "originalRequest": { "url": { "path": [ "accounts", "update_owners" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "account_ids[]", "value": "" }, { "key": "account_ids[]", "value": "" }, { "key": "owner_id", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "\"{\\n \\\"error\\\": \\\"This API key is not authorized to access api/v1/users/search. Request an API key from your administrator that includes this endpoint in its configured scope.\\\",\\n \\\"error_code\\\": \\\"API_INACCESSIBLE\\\"\\n}\"", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1cc24b8f-931b-4a2b-890e-68e170287ff7", "name": "422", "originalRequest": { "url": { "path": [ "accounts", "update_owners" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "account_ids[]", "value": "" }, { "key": "account_ids[]", "value": "" }, { "key": "owner_id", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "\"{\\n \\\"error\\\": \\\"Required parameter 'account_ids' missing\\\"\\n}\"", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6103e8c5-0877-418b-8371-36eacd0334a0", "name": "429", "originalRequest": { "url": { "path": [ "accounts", "update_owners" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "account_ids[]", "value": "" }, { "key": "account_ids[]", "value": "" }, { "key": "owner_id", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "\"{\\n \\\"message\\\": \\\"The maximum number of api calls allowed for api/v1/accounts/update_owners is 600 times per hour. Please upgrade your plan from https://app.apollo.io/#/settings/plans/upgrade.\\\"\\n}\"", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "2132fac9-8a25-40d3-b95b-7b33b25c328c", "name": "List Account Stages", "request": { "name": "List Account Stages", "description": { "content": "## Endpoint essentials\n\n**API key access:** `api/v1/account_stages/index` or `Master API key`\n\n**OAuth scopes:** `account_stages_list`\n\n**Credit usage:** `0 credits` — [Learn more about API pricing and credits](https://docs.apollo.io/docs/api-pricing).\n\nAccount stages help you track progress on sales and marketing pipelines.

Use the List Accounts Stages endpoint to retrieve the IDs for the available account stages in your team's Apollo account. This endpoint doesn't require parameters.

Account stage IDs can be used to update individual accounts and update the account stages for multiple accounts via Apollo API.", "type": "text/plain" }, "url": { "path": [ "account_stages" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "3956e6f0-c542-46c4-b6f4-935e3dd6aa46", "name": "200", "originalRequest": { "url": { "path": [ "account_stages" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "\"{\\n \\\"account_stages\\\": [\\n {\\n \\\"id\\\": \\\"6095a710bd01d100a506d4b7\\\",\\n \\\"team_id\\\": \\\"6095a710bd01d100a506d4ac\\\",\\n \\\"display_name\\\": \\\"Review\\\",\\n \\\"name\\\": \\\"Review\\\",\\n \\\"display_order\\\": 1,\\n \\\"default_exclude_for_leadgen\\\": false,\\n \\\"category\\\": null,\\n \\\"is_meeting_set\\\": null\\n },\\n {\\n \\\"id\\\": \\\"6095a710bd01d100a506d4b8\\\",\\n \\\"team_id\\\": \\\"6095a710bd01d100a506d4ac\\\",\\n \\\"display_name\\\": \\\"Current Client\\\",\\n \\\"name\\\": \\\"Current Client\\\",\\n \\\"display_order\\\": 2,\\n \\\"default_exclude_for_leadgen\\\": true,\\n \\\"category\\\": \\\"succeeded\\\",\\n \\\"is_meeting_set\\\": null\\n },\\n {\\n \\\"id\\\": \\\"6095a710bd01d100a506d4b9\\\",\\n \\\"team_id\\\": \\\"6095a710bd01d100a506d4ac\\\",\\n \\\"display_name\\\": \\\"Active Opportunity\\\",\\n \\\"name\\\": \\\"Active Opportunity\\\",\\n \\\"display_order\\\": 3,\\n \\\"default_exclude_for_leadgen\\\": true,\\n \\\"category\\\": \\\"succeeded\\\",\\n \\\"is_meeting_set\\\": null\\n },\\n {\\n \\\"id\\\": \\\"6095a710bd01d100a506d4ba\\\",\\n \\\"team_id\\\": \\\"6095a710bd01d100a506d4ac\\\",\\n \\\"display_name\\\": \\\"Dead Opportunity\\\",\\n \\\"name\\\": \\\"Dead Opportunity\\\",\\n \\\"display_order\\\": 4,\\n \\\"default_exclude_for_leadgen\\\": false,\\n \\\"category\\\": \\\"failed\\\",\\n \\\"is_meeting_set\\\": null\\n },\\n {\\n \\\"id\\\": \\\"6095a710bd01d100a506d4bb\\\",\\n \\\"team_id\\\": \\\"6095a710bd01d100a506d4ac\\\",\\n \\\"display_name\\\": \\\"Do Not Prospect\\\",\\n \\\"name\\\": \\\"Do Not Prospect\\\",\\n \\\"display_order\\\": 5,\\n \\\"default_exclude_for_leadgen\\\": true,\\n \\\"category\\\": \\\"failed\\\",\\n \\\"is_meeting_set\\\": null\\n },\\n {\\n \\\"id\\\": \\\"61b8e913e0f4d2012e3af74c\\\",\\n \\\"team_id\\\": \\\"6095a710bd01d100a506d4ac\\\",\\n \\\"display_name\\\": \\\"Subscriber\\\",\\n \\\"name\\\": \\\"Subscriber\\\",\\n \\\"display_order\\\": 6,\\n \\\"default_exclude_for_leadgen\\\": false,\\n \\\"category\\\": \\\"in_progress\\\",\\n \\\"is_meeting_set\\\": null\\n },\\n {\\n \\\"id\\\": \\\"61b8e913e0f4d2012e3af74e\\\",\\n \\\"team_id\\\": \\\"6095a710bd01d100a506d4ac\\\",\\n \\\"display_name\\\": \\\"Lead\\\",\\n \\\"name\\\": \\\"Lead\\\",\\n \\\"display_order\\\": 7,\\n \\\"default_exclude_for_leadgen\\\": false,\\n \\\"category\\\": \\\"in_progress\\\",\\n \\\"is_meeting_set\\\": null\\n },\\n {\\n \\\"id\\\": \\\"61b8e913e0f4d2012e3af750\\\",\\n \\\"team_id\\\": \\\"6095a710bd01d100a506d4ac\\\",\\n \\\"display_name\\\": \\\"Marketing Qualified Lead\\\",\\n \\\"name\\\": \\\"Marketing Qualified Lead\\\",\\n \\\"display_order\\\": 8,\\n \\\"default_exclude_for_leadgen\\\": false,\\n \\\"category\\\": \\\"in_progress\\\",\\n \\\"is_meeting_set\\\": null\\n },\\n {\\n \\\"id\\\": \\\"61b8e913e0f4d2012e3af752\\\",\\n \\\"team_id\\\": \\\"6095a710bd01d100a506d4ac\\\",\\n \\\"display_name\\\": \\\"Sales Qualified Lead\\\",\\n \\\"name\\\": \\\"Sales Qualified Lead\\\",\\n \\\"display_order\\\": 9,\\n \\\"default_exclude_for_leadgen\\\": false,\\n \\\"category\\\": \\\"in_progress\\\",\\n \\\"is_meeting_set\\\": null\\n },\\n {\\n \\\"id\\\": \\\"61b8e913e0f4d2012e3af754\\\",\\n \\\"team_id\\\": \\\"6095a710bd01d100a506d4ac\\\",\\n \\\"display_name\\\": \\\"Evangelist\\\",\\n \\\"name\\\": \\\"Evangelist\\\",\\n \\\"display_order\\\": 10,\\n \\\"default_exclude_for_leadgen\\\": false,\\n \\\"category\\\": null,\\n \\\"is_meeting_set\\\": null\\n },\\n {\\n \\\"id\\\": \\\"61b8e913e0f4d2012e3af756\\\",\\n \\\"team_id\\\": \\\"6095a710bd01d100a506d4ac\\\",\\n \\\"display_name\\\": \\\"Other\\\",\\n \\\"name\\\": \\\"Other\\\",\\n \\\"display_order\\\": 11,\\n \\\"default_exclude_for_leadgen\\\": false,\\n \\\"category\\\": null,\\n \\\"is_meeting_set\\\": null\\n }\\n ]\\n}\"", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b0493c3a-dd0b-4230-a069-3a046c853fae", "name": "401", "originalRequest": { "url": { "path": [ "account_stages" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "text/plain" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "Invalid API key. See https://docs.apollo.io/reference/authentication for how to authenticate.", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "91c5f24e-1952-448c-8e05-b854f927f3f2", "name": "403", "originalRequest": { "url": { "path": [ "account_stages" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "\"{\\n \\\"error\\\": \\\"This API key is not authorized to access api/v1/account_stages/index. Request an API key from your administrator that includes this endpoint in its configured scope.\\\",\\n \\\"error_code\\\": \\\"API_INACCESSIBLE\\\"\\n}\"", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0038f599-85e9-458a-b71e-46b4abb7768a", "name": "429", "originalRequest": { "url": { "path": [ "account_stages" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "\"{\\n \\\"message\\\": \\\"The maximum number of api calls allowed for api/v1/account_stages is 600 times per hour. Please upgrade your plan from https://app.apollo.io/#/settings/plans/upgrade.\\\"\\n}\"", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "682426df-ff30-4000-bb59-5eb8e81f08a3", "name": "View an Account", "request": { "name": "View an Account", "description": { "content": "## Endpoint essentials\n\n**API key access:** `api/v1/accounts/show` or `Master API key`\n\n**OAuth scopes:** `account_read`\n\n**Credit usage:** `0 credits` — [Learn more about API pricing and credits](https://docs.apollo.io/docs/api-pricing).\n\nAn account is a company saved in Apollo.

Use the View an Account endpoint to retrieve details for an existing account.", "type": "text/plain" }, "url": { "path": [ "accounts", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) The Apollo ID for the account that you want to retrieve.

To find account IDs, call the Search for Accounts endpoint and identify the `id` value for the account.

Example: `6518c6184f20350001a0b9c0`" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "f188bf3a-3678-4500-9fcc-352b3d22d91f", "originalRequest": { "url": { "path": [ "accounts", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) The Apollo ID for the account that you want to retrieve.

To find account IDs, call the Search for Accounts endpoint and identify the `id` value for the account.

Example: `6518c6184f20350001a0b9c0`" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"account\": {\n \"id\": \"6518c6184f20350001a0b9c0\",\n \"name\": \"Apollo.io\",\n \"website_url\": \"http://www.apollo.io\",\n \"linkedin_url\": \"http://www.linkedin.com/company/apolloio\",\n \"twitter_url\": \"https://twitter.com/MeetApollo/\",\n \"facebook_url\": \"https://facebook.com/MeetApollo/\",\n \"alexa_ranking\": 3514,\n \"linkedin_uid\": \"18511550\",\n \"founded_year\": 2015,\n \"logo_url\": \"https://zenprospect-production.s3.amazonaws.com/uploads/pictures/b1bdd6009b1611149b56f0bc/picture\",\n \"primary_domain\": \"apollo.io\",\n \"industry\": \"information technology & services\",\n \"estimated_num_employees\": 910,\n \"keywords\": [\n \"sales engagement\",\n \"lead generation\",\n \"predictive analytics\",\n \"lead scoring\",\n \"sales strategy\",\n \"conversation intelligence\",\n \"sales enablement\",\n \"lead routing\",\n \"sales development\",\n \"email engagement\",\n \"revenue intelligence\",\n \"sales operations\",\n \"sales intelligence\",\n \"lead intelligence\",\n \"prospecting\",\n \"b2b data\",\n \"software development\",\n \"crm integration\",\n \"data enrichment\",\n \"deal management\",\n \"pipeline management\",\n \"automated workflows\",\n \"analytics & reporting\",\n \"coaching & feedback\",\n \"signal-based prospecting\",\n \"inbound optimization\",\n \"contact & account search\",\n \"email outreach automation\",\n \"meeting scheduling\",\n \"ai sales assistant\",\n \"multi-channel outreach\",\n \"lead qualification\",\n \"form optimization\",\n \"sales performance improvement\",\n \"live data network\",\n \"ai sales automation\",\n \"revops tools\",\n \"account-based prospecting\",\n \"sales pipeline\",\n \"meeting preparedness\",\n \"ai recommendations\",\n \"webinar integration\",\n \"sales coaching\",\n \"team collaboration\",\n \"sales insights\",\n \"buyer's journey tracking\",\n \"market intelligence\",\n \"lead prioritization\",\n \"customer journey mapping\",\n \"sales funnel tracking\",\n \"data-driven sales\",\n \"email deliverability management\",\n \"automated lead follow-up\",\n \"predictive analytics for sales\",\n \"sales campaign management\",\n \"sales productivity tools\",\n \"sales performance management\",\n \"b2b sales intelligence\",\n \"ai-driven automation\",\n \"prospecting tools\",\n \"contact database\",\n \"sales automation\",\n \"email tracking\",\n \"intent data\",\n \"sales workflow management\",\n \"advanced search filters\",\n \"customer success\",\n \"scalable solutions\",\n \"sales analytics\",\n \"outreach optimization\",\n \"data-driven strategies\",\n \"customer acquisition\",\n \"sales productivity\",\n \"marketing automation\",\n \"user-friendly interface\",\n \"comprehensive features\",\n \"business growth\",\n \"sales optimization\",\n \"competitive advantage\",\n \"market potential\",\n \"sales teams\",\n \"enterprise solutions\",\n \"small business support\",\n \"mid-market focus\",\n \"diverse industries\",\n \"customer demographics\",\n \"sales intelligence platform\",\n \"marketing & advertising\",\n \"sales\",\n \"information technology & services\",\n \"enterprise software\",\n \"enterprises\",\n \"computer software\",\n \"b2b\",\n \"saas\"\n ],\n \"industries\": [\n \"information technology & services\"\n ],\n \"secondary_industries\": [],\n \"snippets_loaded\": true,\n \"industry_tag_id\": \"5567cd4773696439b10b0000\",\n \"industry_tag_hash\": {\n \"information technology & services\": \"5567cd4773696439b10b0000\"\n },\n \"retail_location_count\": 0,\n \"raw_address\": \"535 mission st, san francisco, california, united states, 94105\",\n \"street_address\": \"535 Mission Street\",\n \"city\": \"San Francisco\",\n \"state\": \"California\",\n \"country\": \"United States\",\n \"postal_code\": \"94105\",\n \"owned_by_organization_id\": null,\n \"short_description\": \"Apollo.io is an AI sales platform that provides businesses with tools to enhance their go-to-market strategies. Founded in 2015 by Tim and Ray, the company was created to address the limitations of existing sales tools they encountered in their previous startup. Apollo.io offers an all-in-one platform that integrates lead intelligence and sales engagement capabilities, helping businesses find leads, engage prospects, and close deals more effectively.\\n\\nThe platform features detailed insights into potential customers, tools for managing leads from initial contact to deal closure, and a community-based approach to data accuracy. Apollo.io serves nearly 9,000 paying customers, including startups and large enterprises, and supports over 500,000 sales professionals globally. The company has experienced rapid growth, surpassing $100 million in annual recurring revenue and achieving a valuation of $1.6 billion. Apollo.io has also received funding from notable investors like Y Combinator and Nexus Venture Partners.\",\n \"suborganizations\": [],\n \"num_suborganizations\": 0,\n \"annual_revenue_printed\": \"100M\",\n \"annual_revenue\": 100000000,\n \"total_funding\": 251200000,\n \"total_funding_printed\": \"251.2M\",\n \"latest_funding_round_date\": \"2023-08-01T00:00:00.000+00:00\",\n \"latest_funding_stage\": \"Series D\",\n \"funding_events\": [\n {\n \"id\": \"6574c1ff9b797d0001fdab1b\",\n \"date\": \"2023-08-01T00:00:00.000+00:00\",\n \"news_url\": null,\n \"type\": \"Series D\",\n \"investors\": \"Bain Capital Ventures, Sequoia Capital, Tribe Capital, Nexus Venture Partners\",\n \"amount\": \"100M\",\n \"currency\": \"$\"\n },\n {\n \"id\": \"624f4dfec786590001768016\",\n \"date\": \"2022-03-01T00:00:00.000+00:00\",\n \"news_url\": null,\n \"type\": \"Series C\",\n \"investors\": \"Sequoia Capital, Tribe Capital, Nexus Venture Partners, NewView Capital\",\n \"amount\": \"110M\",\n \"currency\": \"$\"\n },\n {\n \"id\": \"61b13677623110000186a478\",\n \"date\": \"2021-10-01T00:00:00.000+00:00\",\n \"news_url\": null,\n \"type\": \"Series B\",\n \"investors\": \"Tribe Capital, NewView Capital, Nexus Venture Partners\",\n \"amount\": \"32M\",\n \"currency\": \"$\"\n },\n {\n \"id\": \"5ffe93caa54d75077c59acef\",\n \"date\": \"2018-06-26T00:00:00.000+00:00\",\n \"news_url\": \"https://techcrunch.com/2018/06/26/yc-grad-zenprospect-rebrands-as-apollo-lands-7-m-series-a/\",\n \"type\": \"Series A\",\n \"investors\": \"Nexus Venture Partners, Social Capital, Y Combinator\",\n \"amount\": \"7M\",\n \"currency\": \"$\"\n },\n {\n \"id\": \"6574c1ff9b797d0001fdab20\",\n \"date\": \"2016-10-01T00:00:00.000+00:00\",\n \"news_url\": null,\n \"type\": \"Other\",\n \"investors\": \"Y Combinator, SV Angel, Social Capital, Nexus Venture Partners\",\n \"amount\": \"2.2M\",\n \"currency\": \"$\"\n }\n ],\n \"technology_names\": [\n \"AI\",\n \"Android\",\n \"Basis\",\n \"Canva\",\n \"Circle\",\n \"CloudFlare Hosting\",\n \"Cloudflare DNS\",\n \"Drift\",\n \"Gmail\",\n \"Google Apps\",\n \"Google Tag Manager\",\n \"Google Workspace\",\n \"Hubspot\",\n \"Microsoft Office 365\",\n \"Mobile Friendly\",\n \"Python\",\n \"Rackspace MailGun\",\n \"Remote\",\n \"Render\",\n \"Reviews\",\n \"Salesforce\",\n \"SharePoint\",\n \"Stripe\",\n \"WP Engine\",\n \"Webmail\",\n \"Zendesk\"\n ],\n \"current_technologies\": [\n {\n \"uid\": \"ai\",\n \"name\": \"AI\",\n \"category\": \"Other\"\n },\n {\n \"uid\": \"android\",\n \"name\": \"Android\",\n \"category\": \"Frameworks and Programming Languages\"\n },\n {\n \"uid\": \"basis\",\n \"name\": \"Basis\",\n \"category\": \"Advertising Networks\"\n },\n {\n \"uid\": \"canva\",\n \"name\": \"Canva\",\n \"category\": \"Content Management Platform\"\n },\n {\n \"uid\": \"circle\",\n \"name\": \"Circle\",\n \"category\": \"Financial Software\"\n },\n {\n \"uid\": \"cloudflare_hosting\",\n \"name\": \"CloudFlare Hosting\",\n \"category\": \"Hosting\"\n },\n {\n \"uid\": \"cloudflare_dns\",\n \"name\": \"Cloudflare DNS\",\n \"category\": \"Domain Name Services\"\n },\n {\n \"uid\": \"drift\",\n \"name\": \"Drift\",\n \"category\": \"Widgets\"\n },\n {\n \"uid\": \"gmail\",\n \"name\": \"Gmail\",\n \"category\": \"Email Providers\"\n },\n {\n \"uid\": \"google_apps\",\n \"name\": \"Google Apps\",\n \"category\": \"Other\"\n },\n {\n \"uid\": \"google_tag_manager\",\n \"name\": \"Google Tag Manager\",\n \"category\": \"Tag Management\"\n },\n {\n \"uid\": \"google workspace\",\n \"name\": \"Google Workspace\",\n \"category\": \"Cloud Services\"\n },\n {\n \"uid\": \"hubspot\",\n \"name\": \"Hubspot\",\n \"category\": \"Marketing Automation\"\n },\n {\n \"uid\": \"office_365\",\n \"name\": \"Microsoft Office 365\",\n \"category\": \"Other\"\n },\n {\n \"uid\": \"mobile_friendly\",\n \"name\": \"Mobile Friendly\",\n \"category\": \"Other\"\n },\n {\n \"uid\": \"python\",\n \"name\": \"Python\",\n \"category\": \"Frameworks and Programming Languages\"\n },\n {\n \"uid\": \"rackspace_mailgun\",\n \"name\": \"Rackspace MailGun\",\n \"category\": \"Email Delivery\"\n },\n {\n \"uid\": \"remote\",\n \"name\": \"Remote\",\n \"category\": \"Other\"\n },\n {\n \"uid\": \"render\",\n \"name\": \"Render\",\n \"category\": \"Other\"\n },\n {\n \"uid\": \"reviews\",\n \"name\": \"Reviews\",\n \"category\": \"Customer Reviews\"\n },\n {\n \"uid\": \"salesforce\",\n \"name\": \"Salesforce\",\n \"category\": \"Customer Relationship Management\"\n },\n {\n \"uid\": \"sharepoint\",\n \"name\": \"SharePoint\",\n \"category\": \"CMS\"\n },\n {\n \"uid\": \"stripe\",\n \"name\": \"Stripe\",\n \"category\": \"Payments\"\n },\n {\n \"uid\": \"wp_engine\",\n \"name\": \"WP Engine\",\n \"category\": \"CMS\"\n },\n {\n \"uid\": \"webmail\",\n \"name\": \"Webmail\",\n \"category\": \"Email Providers\"\n },\n {\n \"uid\": \"zendesk\",\n \"name\": \"Zendesk\",\n \"category\": \"Support and Feedback\"\n }\n ],\n \"org_chart_root_people_ids\": [\n \"66f6de0d74c57a00015d2b39\"\n ],\n \"org_chart_sector\": \"OrgChart::SectorHierarchy::Rules::IT\",\n \"org_chart_removed\": false,\n \"org_chart_show_department_filter\": true,\n \"organization_raw_address\": \"535 mission street, san francisco, california, united states, 94105\",\n \"organization_postal_code\": \"94105\",\n \"organization_street_address\": \"535 Mission Street\",\n \"organization_city\": \"San Francisco\",\n \"organization_state\": \"California\",\n \"organization_country\": \"United States\",\n \"suggest_location_enrichment\": false,\n \"domain\": \"apollo.io\",\n \"team_id\": \"6095a710bd01d100a506d4ac\",\n \"organization_id\": \"5e66b6381e05b4008c8331b8\",\n \"account_stage_id\": \"6095a710bd01d100a506d4b9\",\n \"source\": \"job_change\",\n \"original_source\": \"job_change\",\n \"creator_id\": \"60affe7d6e270a00f5db6fe4\",\n \"owner_id\": \"66302798d03b9601c7934ec2\",\n \"created_at\": \"2023-10-01T01:06:32.057Z\",\n \"phone\": \"+1 415-555-0181\",\n \"phone_status\": \"no_status\",\n \"salesforce_id\": \"0017ntaJPTvuIbOUVM\",\n \"crm_owner_id\": \"005dK4PthD6owdyIkD\",\n \"engagement_graph\": [\n {\n \"year\": 2024,\n \"month\": 7,\n \"inbound\": 0,\n \"outbound\": 2\n },\n {\n \"year\": 2025,\n \"month\": 1,\n \"inbound\": 0,\n \"outbound\": 2\n },\n {\n \"year\": 2025,\n \"month\": 2,\n \"inbound\": 0,\n \"outbound\": 1\n },\n {\n \"year\": 2025,\n \"month\": 3,\n \"inbound\": 0,\n \"outbound\": 4\n },\n {\n \"year\": 2025,\n \"month\": 4,\n \"inbound\": 0,\n \"outbound\": 3\n }\n ],\n \"sanitized_phone\": \"+14155550181\",\n \"account_playbook_statuses\": [],\n \"existence_level\": \"full\",\n \"label_ids\": [\n \"6504905b21ba8e00a334eb0f\"\n ],\n \"typed_custom_fields\": {\n \"671932d76c03c402d0528199\": [\n \"671932d76c03c402d0528195\"\n ]\n },\n \"custom_field_errors\": {},\n \"modality\": \"account\",\n \"source_display_name\": \"Job Change\",\n \"salesforce_record_url\": \"https://orgfarm-1a2b3c4d5e-dev-ed.develop.my.salesforce.com/0017ntaJPTvuIbOUVM\",\n \"crm_record_url\": null,\n \"contact_emailer_campaign_ids\": [\n \"61964b4f2f2b4801128bdccf\",\n \"617006aa01d9c3008c563b80\",\n \"6137561c78029300a4442f2c\",\n \"61df24be4ed86000a4f05dab\",\n \"624dbc81790dd000a518a8f7\",\n \"626975c09d940c00a5e0685d\",\n \"624b4d82f6a95501165cafcc\",\n \"626a709fa58d1c008d9a9deb\",\n \"626a8ed480fa5f00ddebaae3\",\n \"657c8b7bc0ee7301c689fbbe\",\n \"65820320ea75fb06b0921560\",\n \"66425e61b56bc503009c8c15\",\n \"66a97236a8759801b5417678\",\n \"66e9e215ece19801b219997f\",\n \"6462b4b66ec01300a3388865\",\n \"665755d24404d001d65dd7ea\",\n \"672131a9213b0403ebbfcf20\",\n \"6480faa352529300f1501086\",\n \"66186b69391e0901c7dc89b0\",\n \"6789e720c2277502d07c33ee\",\n \"681a8f70182476001d4115f1\",\n \"67bde6d5b5eeec0021ad09c2\",\n \"67be333b81ca47000d1cfb9f\",\n \"680011ea812b54001dcd28c6\",\n \"60c0ec0be9da2200a425bfd1\",\n \"65ea4082b0815b01ae2f248b\",\n \"662a75fe1d925201c7a8c26d\",\n \"6567758e12b81a0264ab0bb1\"\n ],\n \"contact_campaign_status_tally\": {\n \"active\": 29,\n \"finished\": 27,\n \"not_sent\": 25,\n \"paused\": 10,\n \"bounced\": 1\n },\n \"num_contacts\": 100,\n \"last_activity_date\": \"2025-04-25T18:46:35.000+00:00\",\n \"show_intent\": false,\n \"intent_signal_account\": null,\n \"organization_headcount_six_month_growth\": null,\n \"organization_headcount_twelve_month_growth\": null,\n \"organization_headcount_twenty_four_month_growth\": null,\n \"account_queues\": [],\n \"disable_flag\": false\n },\n \"salesforce_users\": [],\n \"hubspot_owners\": []\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1253cc7a-1b00-4a1f-b07f-cfb3b98d4c67", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "accounts", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) The Apollo ID for the account that you want to retrieve.

To find account IDs, call the Search for Accounts endpoint and identify the `id` value for the account.

Example: `6518c6184f20350001a0b9c0`" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "text/plain" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "Invalid API key. See https://docs.apollo.io/reference/authentication for how to authenticate.", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "d5f41589-39c7-49c5-a8a7-82f0b806f4ee", "name": "Forbidden", "originalRequest": { "url": { "path": [ "accounts", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) The Apollo ID for the account that you want to retrieve.

To find account IDs, call the Search for Accounts endpoint and identify the `id` value for the account.

Example: `6518c6184f20350001a0b9c0`" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "\"{\\n \\\"error\\\": \\\"This API key is not authorized to access api/v1/accounts/show. Request an API key from your administrator that includes this endpoint in its configured scope.\\\",\\n \\\"error_code\\\": \\\"API_INACCESSIBLE\\\"\\n}\"", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f0ca8db4-ae15-4fe2-aafd-40700451be54", "name": "Unprocessable Entity", "originalRequest": { "url": { "path": [ "accounts", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) The Apollo ID for the account that you want to retrieve.

To find account IDs, call the Search for Accounts endpoint and identify the `id` value for the account.

Example: `6518c6184f20350001a0b9c0`" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"Parameters misconfigured. id is not a valid ID\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] } ], "event": [], "variable": [ { "type": "string", "value": "https://api.apollo.io/api/v1", "key": "baseUrl" } ], "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "x-api-key" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] }, "info": { "_postman_id": "a5d79f7c-c428-40f9-bd8f-bc9d1b314901", "name": "Apollo API — Accounts", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "description": { "content": "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).\n\nContact Support:\n Name: Apollo API Support", "type": "text/plain" } } }