Apollo API Reference

Welcome to the Apollo API!

Our API is still under active development. It is subject to change without prior notice from Apollo.

Eventually, we plan to make available in the API almost everything you can do in the UI, plus some extra functionality not available in the UI. Additionally, if you have any suggestions for API methods you’d like to see, please let us know! We would be happy to see if we can build it into our API.

Note: Users of curl.exe on Windows OS must escape all double quotes for requests to work
i.e doublequotes around data, and doublequotes escaped with a backslash

# With shell, you can just pass the correct header with each request curl -X GET -H “Content-Type: application/json” -H “Cache-Control: no-cache” “https://api.apollo.io/v1/auth/health?api_key=YOUR_API_KEY_HERE” import requests url = “https://api.apollo.io/v1/auth/health” querystring = { “api_key”: “YOUR API KEY HERE” } headers = { ‘Cache-Control’: ‘no-cache’, ‘Content-Type’: ‘application/json’ } response = requests.request(“GET”, url, headers=headers, params=querystring) print(response.text)

Apollo uses API keys to allow access to the API. You may request an API key here

Apollo expects the API key to be included in all API requests to the server as a query string parameter.

You must replace YOUR_API_KEY with your personal API key.

{ “x-daily-requests-left”: 295, “x-daily-usage”: 5, “x-hourly-requests-left”: 95, “x-hourly-usage”: 5, “x-minute-requests-left”: 45, “x-minute-usage”: 5, “x-rate-limit-daily”: 300, “x-rate-limit-hourly”: 100, “x-rate-limit-minute”: 50 }

Requests to our API will be limited in accordance with your current pricing plan, detailed here under Compare Plans > CRM > API Access.

To view how many requests your current plan allows, as well as how many requests you have used, you can reference the headers of a successful response from the API. See the sample response to the right for more detail.

We use a fixed-window rate limiting strategy for calls to our API. If your team’s rate limit is 50 requests per minute, those 50 api calls can be made at any interval within the 60 second window.

Header Name	Description	Example
x-daily-requests-left	the total requests left for the current 24 hour period	295
x-daily-usage	the total requests used for the current 24 hour period	5
x-hourly-requests-left	the total requests left for the current 60 minute period	95
x-hourly-usage	the total requests used for the current 60 minute period	5
x-minute-requests-left	the total requests left for the current 60 second period	45
x-minute-usage	the total requests used for the current 60 second period	5
x-rate-limit-daily	based on your plan	300
x-rate-limit-hourly	based on your plan	100
x-rate-limit-minute	based on your plan	50

Contents

Bulk People Enrichment

curl -X POST -H “Content-Type: application/json” -H “Cache-Control: no-cache” -d ‘{ “api_key”: “YOUR API KEY HERE”, “details”: [ { “first_name”: “Tim”, “last_name”: “Zheng”, “domain”: “apollo.io”, “email”: “[email protected]”, “organization_name”: “Apollo” }, { “first_name”: “Roy”, “last_name”: “Chung”, “email”: “[email protected]”, “organization_name”: “Apollo” } ] }’ “https://api.apollo.io/api/v1/people/bulk_match” import requests url = “https://api.apollo.io/api/v1/people/bulk_match” data = { “api_key”: “YOUR API KEY HERE”, “details”: [ { “first_name”: “Tim”, “last_name”: “Zheng”, “domain”: “apollo.io”, “email”: “[email protected]”, “organization_name”: “Apollo” }, { “first_name”: “Roy”, “last_name”: “Chung”, “email”: “[email protected]”, “organization_name”: “Apollo” } ] } headers = { ‘Cache-Control’: ‘no-cache’, ‘Content-Type’: ‘application/json’ } response = requests.request(“POST”, url, headers=headers, json=data) print(response.text)

{ “status”:”success”, “error_code”:null, “error_message”:null, “total_requested_enrichments”:2, “unique_enriched_records”:2, “missing_records”:0, “credits_consumed”:0.02, “matches”:[ { “revealed_for_current_team”:true, “email”:”[email protected]”, “email_status”:”verified”, “id”:”61c2e2d4bbb92a0001509cce”, “first_name”:”Tim”, “last_name”:”Zheng”, “name”:”Tim Zheng”, “linkedin_url”:”http://www.linkedin.com/in/tim-zheng-677ba010″, “title”:”Founder u0026 CEO”, “photo_url”:”https://media-exp1.licdn.com/dms/image/C5603AQGiphGg4YXw4Q/profile-displayphoto-shrink_400_400/0/1527618224366?e=1652918400u0026v=betau0026t=ApFqfgq3DodDHyS3m-1bYH9xQfztL_yqUItyo_7sGEQ”, “twitter_url”:null, “github_url”:null, “facebook_url”:null, “extrapolated_email_confidence”:null, “headline”:”Founder u0026 CEO at Apollo”, “organization_id”:”5e66b6381e05b4008c8331b8″, “state”:”Texas”, “city”:”Austin”, “country”:”United States”, “organization”:{ “id”:”5e66b6381e05b4008c8331b8″, “name”:”Apollo.io”, “website_url”:”http://www.apollo.io”, “blog_url”:null, “angellist_url”:null, “linkedin_url”:”http://www.linkedin.com/company/apolloio”, “twitter_url”:”https://twitter.com/MeetApollo/”, “facebook_url”:”https://www.facebook.com/MeetApollo/”, “primary_phone”:{ “number”:”+1 415-763-6055″, “source”:”Owler” }, “languages”:[ ], “alexa_ranking”:2651, “phone”:”+1 415-763-6055″, “linkedin_uid”:”18511550″, “founded_year”:2015, “publicly_traded_symbol”:null, “publicly_traded_exchange”:null, “logo_url”:”https://zenprospect-production.s3.amazonaws.com/uploads/pictures/62299e01b86a98000152b0c5/picture”, “crunchbase_url”:null, “primary_domain”:”apollo.io”, “persona_counts”:{ }, “industry”:”computer software”, “keywords”:[ “sales engagement”, “lead generation”, “predictive analytics”, “lead scoring”, “sales strategy”, “conversation intelligence”, “sales enablement”, “lead routing”, “sales development”, “email engagement”, “revenue intelligence”, “sales operations”, “demand generation” ], “estimated_num_employees”:200, “snippets_loaded”:true, “industry_tag_id”:”5567cd4e7369643b70010000″, “retail_location_count”:0, “raw_address”:”535 Mission St, Suite 1100, San Francisco, California 94105, US”, “street_address”:”535 Mission St”, “city”:”San Francisco”, “state”:”California”, “postal_code”:”94105″, “country”:”United States” }, “account_id”:”6182b6670e22be00ded90b0f”, “account”:{ “id”:”6182b6670e22be00ded90b0f”, “name”:”Apollo.io”, “website_url”:”http://www.apollo.io”, “blog_url”:null, “angellist_url”:null, “linkedin_url”:”http://www.linkedin.com/company/apolloio”, “twitter_url”:”https://twitter.com/MeetApollo/”, “facebook_url”:”https://www.facebook.com/MeetApollo/”, “primary_phone”:{ “number”:”+1 415-763-6055″, “source”:”Owler” }, “languages”:[ ], “alexa_ranking”:2651, “phone”:”2023741312″, “linkedin_uid”:”18511550″, “founded_year”:2015, “publicly_traded_symbol”:null, “publicly_traded_exchange”:null, “logo_url”:”https://zenprospect-production.s3.amazonaws.com/uploads/pictures/62299e01b86a98000152b0c5/picture”, “crunchbase_url”:null, “primary_domain”:”apollo.io”, “persona_counts”:{ }, “domain”:”apollo.io”, “team_id”:”6181a50999668600ded6fe71″, “organization_id”:”5e66b6381e05b4008c8331b8″, “account_stage_id”:”6181a50999668600ded6fe7c”, “source”:”deployment”, “original_source”:”deployment”, “owner_id”:”6181a50a99668600ded6feed”, “created_at”:”2021-11-03T16:18:47.229Z”, “phone_status”:”no_status”, “test_predictive_score”:null, “hubspot_id”:null, “salesforce_id”:null, “crm_owner_id”:null, “parent_account_id”:null, “sanitized_phone”:”+12023741312″, “account_playbook_statuses”:[ { “_id”:”61844b47a4258e00c2499c8e”, “added_by_id”:”6181a50a99668600ded6feed”, “added_on”:”2021-11-04T21:06:15.053+00:00″, “completed_step_ids”:[ “6184391f26e0aa00a4ccc56b” ], “created_at”:null, “current_step_id”:”61844dba8b94530112288546″, “finished_reason_cd”:”completed_all_steps”, “paused_reason_cd”:null, “playbook_id”:”6184388a0515e4008cbf5129″, “position”:2, “status_cd”:”finished”, “updated_at”:null, “id”:”61844b47a4258e00c2499c8e”, “key”:”61844b47a4258e00c2499c8e” } ], “existence_level”:”full”, “label_ids”:[ ], “typed_custom_fields”:{ “618438b906b01300da086546″:”Google, Okta, Lyft” }, “modality”:”account” }, “phone_numbers”:[ { “raw_number”:”+1 415-763-6055″, “sanitized_number”:”+14157636055″, “type”:”work_hq”, “position”:0, “status”:”no_status” } ] }, { “revealed_for_current_team”:true, “email”:”[email protected]”, “email_status”:”verified”, “id”:”611c931f1b404b00014e884c”, “first_name”:”Roy”, “last_name”:”Chung”, “name”:”Roy Chung”, “linkedin_url”:”http://www.linkedin.com/in/royychung”, “title”:”Chief Business Officer”, “photo_url”:”https://media-exp1.licdn.com/dms/image/C5603AQFVolaIjLeG3g/profile-displayphoto-shrink_200_200/0/1517707907539?e=1652918400u0026v=betau0026t=cpM4yiTrGbgwEiM61eTYIsdW83u-bmv4m27hiaiJppU”, “twitter_url”:”https://twitter.com/r1strategy”, “github_url”:null, “facebook_url”:null, “extrapolated_email_confidence”:null, “headline”:”Founder @ Apollo – We’re Hiring! “, “organization_id”:”5e66b6381e05b4008c8331b8″, “state”:”California”, “city”:”San Francisco”, “country”:”United States”, “organization”:{ “id”:”5e66b6381e05b4008c8331b8″, “name”:”Apollo.io”, “website_url”:”http://www.apollo.io”, “blog_url”:null, “angellist_url”:null, “linkedin_url”:”http://www.linkedin.com/company/apolloio”, “twitter_url”:”https://twitter.com/MeetApollo/”, “facebook_url”:”https://www.facebook.com/MeetApollo/”, “primary_phone”:{ “number”:”+1 415-763-6055″, “source”:”Owler” }, “languages”:[ ], “alexa_ranking”:2651, “phone”:”+1 415-763-6055″, “linkedin_uid”:”18511550″, “founded_year”:2015, “publicly_traded_symbol”:null, “publicly_traded_exchange”:null, “logo_url”:”https://zenprospect-production.s3.amazonaws.com/uploads/pictures/62299e01b86a98000152b0c5/picture”, “crunchbase_url”:null, “primary_domain”:”apollo.io”, “persona_counts”:{ }, “industry”:”computer software”, “keywords”:[ “sales engagement”, “lead generation”, “predictive analytics”, “lead scoring”, “sales strategy”, “conversation intelligence”, “sales enablement”, “lead routing”, “sales development”, “email engagement”, “revenue intelligence”, “sales operations”, “demand generation” ], “estimated_num_employees”:200, “snippets_loaded”:true, “industry_tag_id”:”5567cd4e7369643b70010000″, “retail_location_count”:0, “raw_address”:”535 Mission St, Suite 1100, San Francisco, California 94105, US”, “street_address”:”535 Mission St”, “city”:”San Francisco”, “state”:”California”, “postal_code”:”94105″, “country”:”United States” }, “account_id”:”6182b6670e22be00ded90b0f”, “account”:{ “id”:”6182b6670e22be00ded90b0f”, “name”:”Apollo.io”, “website_url”:”http://www.apollo.io”, “blog_url”:null, “angellist_url”:null, “linkedin_url”:”http://www.linkedin.com/company/apolloio”, “twitter_url”:”https://twitter.com/MeetApollo/”, “facebook_url”:”https://www.facebook.com/MeetApollo/”, “primary_phone”:{ “number”:”+1 415-763-6055″, “source”:”Owler” }, “languages”:[ ], “alexa_ranking”:2651, “phone”:”2023741312″, “linkedin_uid”:”18511550″, “founded_year”:2015, “publicly_traded_symbol”:null, “publicly_traded_exchange”:null, “logo_url”:”https://zenprospect-production.s3.amazonaws.com/uploads/pictures/62299e01b86a98000152b0c5/picture”, “crunchbase_url”:null, “primary_domain”:”apollo.io”, “persona_counts”:{ }, “domain”:”apollo.io”, “team_id”:”6181a50999668600ded6fe71″, “organization_id”:”5e66b6381e05b4008c8331b8″, “account_stage_id”:”6181a50999668600ded6fe7c”, “source”:”deployment”, “original_source”:”deployment”, “owner_id”:”6181a50a99668600ded6feed”, “created_at”:”2021-11-03T16:18:47.229Z”, “phone_status”:”no_status”, “test_predictive_score”:null, “hubspot_id”:null, “salesforce_id”:null, “crm_owner_id”:null, “parent_account_id”:null, “sanitized_phone”:”+12023741312″, “account_playbook_statuses”:[ { “_id”:”61844b47a4258e00c2499c8e”, “added_by_id”:”6181a50a99668600ded6feed”, “added_on”:”2021-11-04T21:06:15.053+00:00″, “completed_step_ids”:[ “6184391f26e0aa00a4ccc56b” ], “created_at”:null, “current_step_id”:”61844dba8b94530112288546″, “finished_reason_cd”:”completed_all_steps”, “paused_reason_cd”:null, “playbook_id”:”6184388a0515e4008cbf5129″, “position”:2, “status_cd”:”finished”, “updated_at”:null, “id”:”61844b47a4258e00c2499c8e”, “key”:”61844b47a4258e00c2499c8e” } ], “existence_level”:”full”, “label_ids”:[ ], “typed_custom_fields”:{ “618438b906b01300da086546″:”Google, Okta, Lyft” }, “modality”:”account” }, “phone_numbers”:[ { “raw_number”:”+1 415-763-6055″, “sanitized_number”:”+14157636055″, “type”:”work_hq”, “position”:0, “status”:”no_status” } ] } ] }

This endpoint enriches people information in bulk – the more information you pass in, the more likely we can find a match.

Up to 10 records can be enriched at the same time through this endpoint.

Credit Usage

The enrich endpoint charges you credits for its usage. If a verified email is successfully returned, it will cost you 1 credit. If an email is not found, but Apollo successfully found ALL of the following information: Name, Linkedin Profile, Current Company Information, Apollo will charge a fraction of a credit. Typically this is 0.01 credit per successful enrichment without email. But it may be higher depending on your specific plan.

Duplicate enrichments of the same record will not be charged credits.

Rate Limits

Rate limits on this endpoint are 1/10th of what is available on the single enrichment endpoint.

POST https://api.apollo.io/api/v1/people/bulk_match

Request Parameters

Parameter	Description	Example
first_name (optional)	The person’s first name	Tim
last_name (optional)	The person’s last name	Zheng
name (optional)	The person’s full name	Tim Zheng
email (optional)	The person’s email	[email protected]
organization_name (optional)	The person’s company name	Apollo Inc.
domain (optional)	The person’s company domain	apollo.io
id (optional)	The person’s ID obtained from the search endpoint	“583f2f7ed9ced98ab5bfXXXX”

Bulk Organization Enrichment

curl -X POST -H “Content-Type: application/json” -H “Cache-Control: no-cache” -d ‘{ “api_key”: “YOUR API KEY HERE”, “domains”: [ “apollo.io”, “outreach.com”, “microsoft.com” ] }’ “https://api.apollo.io/api/v1/organizations/bulk_enrich” import requests url = “https://api.apollo.io/api/v1/organizations/bulk_enrich” data = { “api_key”: “YOUR API KEY HERE”, “domains”: [ “apollo.io”, “outreach.com”, “microsoft.com” ] } headers = { ‘Cache-Control’: ‘no-cache’, ‘Content-Type’: ‘application/json’ } response = requests.request(“POST”, url, headers=headers, json=data) print(response.text)

{ “status”:”success”, “error_code”:null, “error_message”:null, “total_requested_domains”:3, “unique_domains”:3, “unique_enriched_records”:3, “missing_records”:0, “organizations”:[ { “id”:”5e66b6381e05b4008c8331b8″, “name”:”Apollo.io”, “website_url”:”http://www.apollo.io”, “blog_url”:null, “angellist_url”:null, “linkedin_url”:”http://www.linkedin.com/company/apolloio”, “twitter_url”:”https://twitter.com/MeetApollo/”, “facebook_url”:”https://www.facebook.com/MeetApollo/”, “primary_phone”:{ “number”:”+1 415-763-6055″, “source”:”Owler” }, “languages”:[ ], “alexa_ranking”:2651, “phone”:”+1 415-763-6055″, “linkedin_uid”:”18511550″, “founded_year”:2015, “publicly_traded_symbol”:null, “publicly_traded_exchange”:null, “logo_url”:”https://zenprospect-production.s3.amazonaws.com/uploads/pictures/6232fbed6106460001ca5dc7/picture”, “crunchbase_url”:null, “primary_domain”:”apollo.io”, “persona_counts”:{ }, “industry”:”computer software”, “keywords”:[ “sales engagement”, “lead generation”, “predictive analytics”, “lead scoring”, “sales strategy”, “conversation intelligence”, “sales enablement”, “lead routing”, “sales development”, “email engagement”, “revenue intelligence”, “sales operations”, “demand generation” ], “estimated_num_employees”:210, “snippets_loaded”:true, “industry_tag_id”:”5567cd4e7369643b70010000″, “retail_location_count”:0, “raw_address”:”535 mission st, suite 1100, san francisco, california 94105, us”, “street_address”:”535 Mission St”, “city”:”San Francisco”, “state”:”California”, “country”:”United States”, “postal_code”:”94105″, “owned_by_organization_id”:null, “account_id”:”6182b6670e22be00ded90b0f”, “account”:{ “id”:”6182b6670e22be00ded90b0f”, “domain”:”apollo.io”, “name”:”Apollo.io”, “team_id”:”6181a50999668600ded6fe71″, “organization_id”:”5e66b6381e05b4008c8331b8″, “account_stage_id”:”6181a50999668600ded6fe7c”, “source”:”deployment”, “original_source”:”deployment”, “owner_id”:”6181a50a99668600ded6feed”, “created_at”:”2021-11-03T16:18:47.229Z”, “phone”:”2023741312″, “phone_status”:”no_status”, “test_predictive_score”:null, “hubspot_id”:null, “salesforce_id”:null, “crm_owner_id”:null, “parent_account_id”:null, “sanitized_phone”:”+12023741312″, “account_playbook_statuses”:[ { “_id”:”61844b47a4258e00c2499c8e”, “added_by_id”:”6181a50a99668600ded6feed”, “added_on”:”2021-11-04T21:06:15.053+00:00″, “completed_step_ids”:[ “6184391f26e0aa00a4ccc56b” ], “created_at”:null, “current_step_id”:”61844dba8b94530112288546″, “finished_reason_cd”:”completed_all_steps”, “paused_reason_cd”:null, “playbook_id”:”6184388a0515e4008cbf5129″, “position”:2, “status_cd”:”finished”, “updated_at”:null, “id”:”61844b47a4258e00c2499c8e”, “key”:”61844b47a4258e00c2499c8e” } ], “existence_level”:”full”, “label_ids”:[ ], “typed_custom_fields”:{ “618438b906b01300da086546″:”Google, Okta, Lyft” }, “modality”:”account”, “persona_counts”:{ } }, “departmental_head_count”:{ “engineering”:46, “business_development”:14, “support”:21, “finance”:2, “marketing”:10, “administrative”:1, “product_management”:7, “arts_and_design”:8, “operations”:7, “accounting”:2, “entrepreneurship”:3, “information_technology”:2, “consulting”:9, “human_resources”:6, “sales”:17, “education”:3, “legal”:0, “media_and_commmunication”:0, “data_science”:0 } }, { “id”:”55ea57fdf3e5bb1430000ac7″, “name”:”Outreach, Inc.”, “website_url”:”http://www.outreach.com”, “blog_url”:null, “angellist_url”:null, “linkedin_url”:”http://www.linkedin.com/company/outreach-inc-“, “twitter_url”:null, “facebook_url”:”https://www.facebook.com/outreachinc”, “primary_phone”:{ “number”:”+1 800-991-6011″, “source”:”Owler” }, “languages”:[ “English”, “English” ], “alexa_ranking”:597090, “phone”:”+1 800-991-6011″, “linkedin_uid”:”314305″, “founded_year”:1996, “publicly_traded_symbol”:null, “publicly_traded_exchange”:null, “logo_url”:”https://zenprospect-production.s3.amazonaws.com/uploads/pictures/623369279d4f650001b93cb3/picture”, “crunchbase_url”:null, “primary_domain”:”outreach.com”, “persona_counts”:{ }, “industry”:”marketing u0026 advertising”, “keywords”:[ “outreach marketing product for christian churches”, “customized design services”, “professional design”, “print u0026 full service delivery”, “targeted mailings done by inhouse mail services”, “thought leader in outreach”, “resource provider u0026 content network”, “churches”, “marketing”, “professional services”, “religious organizations” ], “estimated_num_employees”:170, “snippets_loaded”:true, “industry_tag_id”:”5567cd467369644d39040000″, “retail_location_count”:1, “raw_address”:”5550 tech center drive, colorado springs, co 80919, us”, “street_address”:”5550 Tech Center Drive”, “city”:”Colorado Springs”, “state”:”Colorado”, “country”:”United States”, “postal_code”:”80919″, “owned_by_organization_id”:null, “departmental_head_count”:{ “accounting”:3, “operations”:4, “finance”:2, “arts_and_design”:5, “human_resources”:3, “sales”:11, “marketing”:8, “media_and_commmunication”:7, “product_management”:3, “engineering”:5, “consulting”:6, “support”:4, “entrepreneurship”:2, “information_technology”:5, “business_development”:1, “administrative”:2, “legal”:0, “education”:0, “data_science”:0 } }, { “id”:”5d09312ca3ae61489386b467″, “name”:”Microsoft”, “website_url”:”http://www.microsoft.com”, “blog_url”:null, “angellist_url”:null, “linkedin_url”:”http://www.linkedin.com/company/microsoft”, “twitter_url”:”https://twitter.com/microsoft”, “facebook_url”:”https://facebook.com/Microsoft”, “primary_phone”:{ “number”:”+1 425-882-8080″, “source”:”Owler” }, “languages”:[ “English” ], “alexa_ranking”:19, “phone”:”+1 425-882-8080″, “linkedin_uid”:”1035″, “founded_year”:1975, “publicly_traded_symbol”:”MSFT”, “publicly_traded_exchange”:”nasdaq”, “logo_url”:”https://zenprospect-production.s3.amazonaws.com/uploads/pictures/6232f7976d60b600019c2644/picture”, “crunchbase_url”:null, “primary_domain”:”microsoft.com”, “persona_counts”:{ }, “market_cap”:”2099.6B”, “industry”:”computer software”, “keywords”:[ “business software”, “developer tools”, “home”, “educational software”, “tablets”, “search”, “advertising”, “servers”, “windows operating system”, “windows applications”, “platforms”, “smartphones”, “cloud computing”, “quantum computing”, “future of work”, “productivity”, “ai”, “artificial intelligence”, “machine learning”, “laptops”, “mixed reality”, “virtual reality”, “gaming”, “developers”, “it professional”, “computers”, “electronics”, “mobile phones”, “shopping” ], “estimated_num_employees”:224000, “snippets_loaded”:true, “industry_tag_id”:”5567cd4e7369643b70010000″, “retail_location_count”:96, “raw_address”:”1 microsoft way, redmond, washington 98052, us”, “street_address”:”1 Microsoft Way”, “city”:”Redmond”, “state”:”Washington”, “country”:”United States”, “postal_code”:”98052″, “owned_by_organization_id”:null, “departmental_head_count”:{ “sales”:10117, “business_development”:9413, “engineering”:66732, “media_and_commmunication”:1612, “finance”:3079, “marketing”:5327, “operations”:3747, “support”:12733, “consulting”:5822, “product_management”:4099, “data_science”:1922, “administrative”:350, “education”:13249, “human_resources”:3818, “arts_and_design”:2125, “information_technology”:3727, “legal”:625, “accounting”:476, “entrepreneurship”:121 } } ] }

This endpoint enriches organization information in bulk with info such as industry, company size, etc. based on the domain parameter passed in.

Up to 10 records can be enriched at the same time through this endpoint.

Credit Usage

Duplicate enrichments of the same record will not be charged credits.

Rate Limits

Rate limits on this endpoint are 1/10th of what is available on the single enrichment endpoint.

POST https://api.apollo.io/api/v1/organizations/bulk_enrich

Request Parameters

Parameter	Description	Example
domains	The company domain	google.com

People Enrichment

curl -X POST -H “Content-Type: application/json” -H “Cache-Control: no-cache” -d ‘{ “api_key”: “YOUR API KEY HERE”, “id”: “583f2f7ed9ced98ab5bfXXXX”, “first_name”: “Tim”, “last_name”: “Zheng”, “organization_name”: “Apollo”, “email”: “[email protected]”, “domain”: “apollo.io” }’ “https://api.apollo.io/v1/people/match” import requests url = “https://api.apollo.io/v1/people/match” data = { “api_key”: “YOUR API KEY HERE”, “id”: “583f2f7ed9ced98ab5bfXXXX”, “first_name”: “Tim”, “last_name”: “Zheng”, “organization_name”: “Apollo”, “email”: “[email protected]”, “domain”: “apollo.io” } headers = { ‘Cache-Control’: ‘no-cache’, ‘Content-Type’: ‘application/json’ } response = requests.request(“POST”, url, headers=headers, json=data) print(response.text)

{ “person”: { “id”: “583f2f7ed9ced98ab5bfXXXX”, “first_name”: “Tim”, “last_name”: “Zheng”, “name”: “Tim Zheng”, “linkedin_url”: “http://www.linkedin.com/in/tim-zheng-677ba010”, “title”: “Founder & CEO”, “city”: “San Francisco”, “email_status”: null, “photo_url”: “https://media-server.url”, “twitter_url”: null, “github_url”: null, “facebook_url”: null, “extrapolated_email_confidence”: null, “headline”: “Founder & CEO at Apollo”, “country”: “United States”, “email”: “[email protected]”, “state”: “CA”, “excluded_for_leadgen”: false, “contact_id”: “5da8ceXXXXXXXXXXXXXXXX”, “contact”: { “id”: “5da8ceXXXXXXXXXXXXXXXX”, “first_name”: “Tim”, “last_name”: “Zheng”, “name”: “Tim Zheng”, “linkedin_url”: “http://www.linkedin.com/in/tim-zheng-677ba010”, “title”: “Founder & CEO”, “contact_stage_id”: “5c48fb36ae29ba0f376d11ab”, “owner_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “person_id”: “5eb53cXXXXXXXXXXXXXXXX”, “email_needs_tickling”: false, “organization_name”: “Apollo”, “source”: “search”, “original_source”: “email_import”, “organization_id”: “5e66b6XXXXXXXXXXXXXXXX”, “headline”: “Founder & CEO at Apollo”, “photo_url”: “https://static-exp2.licdn.com/sc/h/djzv59yelk5urv2ujlazfyvrk”, “present_raw_address”: “San Francisco, California, United States”, “linkedin_uid”: “38777275”, “extrapolated_email_confidence”: 0, “salesforce_id”: “0031UXXXXXXXXXXXX”, “salesforce_lead_id”: null, “salesforce_contact_id”: “0031UXXXXXXXXXXXX”, “salesforce_account_id”: “0011UXXXXXXXXXXXX”, “salesforce_owner_id”: “0051UXXXXXXXXXXXX”, “created_at”: “2019-10-17T20:25:07.594Z”, “lead_request_id”: null, “test_predictive_score”: null, “emailer_campaign_ids”: [], “email_manually_changed”: false, “direct_dial_status”: null, “direct_dial_enrichment_failed_at”: null, “email_status”: “verified”, “account_id”: “5f1faXXXXXXXXXXXXXXXX”, “last_activity_date”: “2018-06-26T16:30:35.000+00:00”, “hubspot_vid”: null, “hubspot_company_id”: null, “sanitized_phone”: null, “merged_crm_ids”: [], “typed_custom_fields”: { “5d856e9c6899d00098XXXXXX”: “Tim Zheng” }, “updated_at”: “2020-07-28T04:44:51.448Z”, “queued_for_crm_push”: false, “starred_by_user_ids”: [], “suggested_from_rule_engine_config_id”: null, “label_ids”: [], “has_pending_email_arcgate_request”: false, “has_email_arcgate_request”: false, “existence_level”: “full”, “email”: “[email protected]”, “salesforce_record_url”: “https://na85.salesforce.com/0031UXXXXXXXXXXXX”, “phone_numbers”: [], “account_phone_note”: null }, “revealed_for_current_team”: true, “organization_id”: “5e66b6XXXXXXXXXXXXXXXX”, “organization”: { “id”: “5e66b6XXXXXXXXXXXXXXXX”, “name”: “Apollo”, “website_url”: “http://www.apollo.io”, “blog_url”: null, “angellist_url”: null, “linkedin_url”: “http://www.linkedin.com/company/apolloio”, “twitter_url”: “https://twitter.com/MeetApollo/”, “facebook_url”: “https://www.facebook.com/MeetApollo/”, “languages”: [], “alexa_ranking”: 1955, “phone”: null, “linkedin_uid”: “18511550”, “publicly_traded_symbol”: null, “publicly_traded_exchange”: null, “logo_url”: “https://apollo-server.com/uploads/pictures/5f026XXXXXXXXXXXXXXXX/picture”, “crunchbase_url”: null, “primary_domain”: “apollo.io”, “persona_counts”: {}, “industry”: “computer software”, “keywords”: [ “sales engagement”, “lead generation”, “predictive analytics”, “lead scoring”, “sales strategy”, “conversation intelligence”, “sales enablement”, “lead routing”, “sales development”, “and email engagement” ], “estimated_num_employees”: 38, “snippets_loaded”: true, “industry_tag_id”: “5567cdXXXXXXXXXXXXXXXX”, “retail_location_count”: 0, “raw_address”: “535 Mission St, Suite 1100, San Francisco, California 94105, US”, “street_address”: “535 Mission St”, “city”: “San Francisco”, “state”: “California”, “postal_code”: “94105”, “country”: “United States”, “owned_by_organization_id”: null, “suborganizations”: [], “num_suborganizations”: 0, “seo_description”: “Apollo is an intelligent, data-first engagement platform that puts structured data at the core of your workflows to help you execute, analyze, and improve on your growth strategy.”, “short_description”: “Apollo is the unified engagement acceleration platform that gives reps the ability to dramatically increase their number of quality conversations and opportunities. Reps are …”, “total_funding”: null, “total_funding_printed”: null, “latest_funding_round_date”: null, “latest_funding_stage”: null, “funding_events”: [], “technology_names”: [ “Cloudflare DNS”, “Rackspace MailGun”, “Gmail”, “Marketo”, “Google Apps”, “Microsoft Office 365”, “CloudFlare Hosting”, … ], “current_technologies”: [ { “uid”: “cloudflare_dns”, “name”: “Cloudflare DNS”, “category”: “Domain Name Services” }, { “uid”: “rackspace_mailgun”, “name”: “Rackspace MailGun”, “category”: “Email Delivery” }, { “uid”: “gmail”, “name”: “Gmail”, “category”: “Email Providers” }, { “uid”: “marketo”, “name”: “Marketo”, “category”: “Marketing Automation” }, { “uid”: “google_apps”, “name”: “Google Apps”, “category”: “Other” }, { “uid”: “office_365”, “name”: “Microsoft Office 365”, “category”: “Other” }, { “uid”: “cloudflare_hosting”, “name”: “CloudFlare Hosting”, “category”: “Hosting” }, { … } ] } } }

This endpoint enriches a person’s information, the more information you pass in, the more likely we can find a match.

The enrich endpoint charges credits even if the person is already in your CRM. The enrich endpoint also charges credits if you pass in the same information multiple times.

POST https://api.apollo.io/v1/people/match

Query Parameters

Parameter	Description	Example
first_name (optional)	The person’s first name	Tim
last_name (optional)	The person’s last name	Zheng
name (optional)	The person’s full name	Tim Zheng
email (optional)	The person’s email	[email protected]
organization_name (optional)	The person’s company name	Apollo Inc.
domain (optional)	The person’s company domain	apollo.io
id (optional)	The person’s ID obtained from the search endpoint	“583f2f7ed9ced98ab5bfXXXX”

Organization Enrichment

curl -X GET -H “Content-Type: application/json” -H “Cache-Control: no-cache” “https://api.apollo.io/v1/organizations/enrich?api_key=YOUR_API_KEY_HERE&domain=apollo.io” import requests url = “https://api.apollo.io/v1/organizations/enrich” querystring = { “api_key”: “YOUR API KEY HERE”, “domain”: “apollo.io” } headers = { ‘Cache-Control’: ‘no-cache’, ‘Content-Type’: ‘application/json’ } response = requests.request(“GET”, url, headers=headers, params=querystring) print(response.text)

{ “organization”: { “id”: “5e66b6XXXXXXXXXXXXXXXXXX”, “name”: “Apollo.io”, “website_url”: “http://www.apollo.io”, “blog_url”: null, “angellist_url”: null, “linkedin_url”: “http://www.linkedin.com/company/apolloio”, “twitter_url”: “https://twitter.com/MeetApollo/”, “facebook_url”: “https://www.facebook.com/MeetApollo/”, “primary_phone”: { “number”: “202374XXXX”, “source”: “Account” }, “languages”: [], “alexa_ranking”: 522, “phone”: “202374XXXX”, “linkedin_uid”: “185115XX”, “founded_year”: 2015, “publicly_traded_symbol”: null, “publicly_traded_exchange”: null, “logo_url”: “https://apollo-server.com/uploads/pictures/61824XXXXXXXXXXXXXXXXXXX/picture”, “crunchbase_url”: null, “primary_domain”: “apollo.io”, “persona_counts”: {}, “industry”: “computer software”, “keywords”: [ “sales engagement”, “lead generation”, “predictive analytics”, “lead scoring”, “sales strategy”, “conversation intelligence”, “sales enablement”, “lead routing”, “sales development”, “email engagement”, “revenue intelligence”, “sales operations”, “demand generation” ], “estimated_num_employees”: 170, “snippets_loaded”: true, “industry_tag_id”: “5567cdXXXXXXXXXXXXXXXXXX”, “retail_location_count”: 0, “raw_address”: “535 Mission St, Suite 1100, San Francisco, California 94105, US”, “street_address”: “535 Mission St”, “city”: “San Francisco”, “state”: “California”, “postal_code”: “94105”, “country”: “United States”, “owned_by_organization_id”: null, “suborganizations”: [], “num_suborganizations”: 0, “seo_description”: “Apollo is a data-first engagement platform that embeds intelligence within your workflows to help you execute, analyze, and improve on your growth strategy.”, “short_description”: “Apollo is the unified engagement acceleration platform that gives reps the ability to dramatically increase their number of quality conversations and opportunities. Reps are empowered do more than just conduct outreach, they learn who to target, how to reach out, and what to say at speed and scale. We help drive growth and success by providing the means for teams to discover and utilize their organization’s unique best practices. nnBy working in a unified platform, reps and managers alike save hours of time each day, strategy changes are instantly scaled across the whole team, and managers can finally dig into data at each step of their pipeline to continually find new ways to improve. nnTeams get access to our database of 200+ million contacts with a built-in fully customizable Scoring Engine, full sales engagement stack, our native Account Playbook builder, and the industry’s only custom deep analytics suite. Managers create and enforce order and process with the industry’s most advanced Rules Engine.nnApollo is the foundation for your entire end-to-end sales strategy.nnJoin teams like Autodesk, Copper (ProsperWorks), and Snowflake to experience the future of sales today. Ready to join our crew? Email [email protected] “, “annual_revenue_printed”: “10M”, “annual_revenue”: 10000000, “total_funding”: 9200000, “total_funding_printed”: “9.2M”, “latest_funding_round_date”: “2018-06-26T00:00:00.000+00:00”, “latest_funding_stage”: “Series A”, “funding_events”: [ { “id”: “5ffe93XXXXXXXXXXXXXXXXXX”, “date”: “2018-06-26T00:00:00.000+00:00”, “news_url”: “https://techcrunch.com/2018/06/26/yc-grad-zenprospect-rebrands-as-apollo-lands-7-m-series-a/”, “type”: “Series A”, “investors”: “Nexus Venture Partners”, “amount”: “7M”, “currency”: “$” }, { “id”: “5ffe93XXXXXXXXXXXXXXXXXX”, “date”: “2016-10-01T00:00:00.000+00:00”, “news_url”: null, “type”: “Other”, “investors”: “Y Combinator, SV Angel, Social Capital, Nexus Venture Partners”, “amount”: “2.2M”, “currency”: “$” } ], “technology_names”: [ “Cloudflare DNS”, “Mailchimp Mandrill”, “Gmail”, “Marketo”, “Google Apps”, “Microsoft Office 365”, “CloudFlare Hosting”, “Route 53”, “Zendesk”, “Google Cloud Hosting”, “Stripe”, “Lever”, “Segment.io”, “Amplitude”, “Hubspot”, “Nginx”, “CrazyEgg”, “Squarespace ECommerce”, “Linkedin Marketing Solutions”, “Yandex Metrica”, “Mobile Friendly”, “Typekit”, “Google Tag Manager” ], “current_technologies”: [ { “uid”: “cloudflare_dns”, “name”: “Cloudflare DNS”, “category”: “Domain Name Services” }, { “uid”: “mailchimp_mandrill”, “name”: “Mailchimp Mandrill”, “category”: “Email Delivery” }, { “uid”: “gmail”, “name”: “Gmail”, “category”: “Email Providers” }, { “uid”: “marketo”, “name”: “Marketo”, “category”: “Marketing Automation” } ], “account_id”: “614264XXXXXXXXXXXXXXXXXX”, “account”: { “id”: “614264XXXXXXXXXXXXXXXXXX”, “domain”: “apollo.io”, “name”: “Apollo”, “team_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “organization_id”: “5e66b6XXXXXXXXXXXXXXXXXX”, “account_stage_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “source”: “salesforce”, “original_source”: “salesforce”, “owner_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “created_at”: “2021-09-15T21:24:18.374Z”, “phone”: “(123) 456-XXXX”, “phone_status”: “no_status”, “test_predictive_score”: null, “hubspot_id”: null, “salesforce_id”: “0015g0XXXXXXXXXXXX”, “crm_owner_id”: “0055g0XXXXXXXXXXXX”, “parent_account_id”: null, “sanitized_phone”: “+112345XXXXX”, “account_playbook_statuses”: [], “existence_level”: “full”, “label_ids”: [], “typed_custom_fields”: {}, “modality”: “account”, “persona_counts”: {} }, “departmental_head_count”: { “engineering”: 45, “accounting”: 4, “product_management”: 5, “support”: 31, “arts_and_design”: 10, “sales”: 37, “education”: 6, “consulting”: 10, “human_resources”: 10, “business_development”: 22, “operations”: 10, “finance”: 8, “entrepreneurship”: 4, “marketing”: 7, “information_technology”: 5, “administrative”: 3, “legal”: 0, “media_and_commmunication”: 0, “data_science”: 0 } } }

This endpoint enriches a company with info such as industry, company size, etc. based on the domain parameter passed in.

GET https://api.apollo.io/v1/organizations/enrich

Query Parameters

Parameter	Description	Example
domain	The company domain	google.com

A person represents a person in Apollo’s database.

Search

curl -X POST -H “Content-Type: application/json” -H “Cache-Control: no-cache” -d ‘{ “api_key”: “YOUR API KEY HERE”, “q_organization_domains”: “apollo.iongoogle.com”, “page” : 1, “person_titles” : [“sales manager”, “engineer manager”] }’ “https://api.apollo.io/v1/mixed_people/search” import requests url = “https://api.apollo.io/v1/mixed_people/search” data = { “api_key”: “YOUR API KEY HERE”, “q_organization_domains”: “apollo.iongoogle.com”, “page” : 1, “person_titles” : [“sales manager”, “engineer manager”] } headers = { ‘Cache-Control’: ‘no-cache’, ‘Content-Type’: ‘application/json’ } response = requests.request(“POST”, url, headers=headers, json=data) print(response.text)

{ “breadcrumbs”: [ { “label”: “Titles”, “signal_field_name”: “person_titles”, “value”: “sales manager”, “display_name”: “sales manager” }, { “label”: “Titles”, “signal_field_name”: “person_titles”, “value”: “engineer manager”, “display_name”: “engineer manager” }, { “label”: “Company Domains”, “signal_field_name”: “q_organization_domains”, “value”: [ “apollo.io”, “google.com” ], “display_name”: “apollo.io, google.com” } ], “partial_results_only”: false, “partial_results_limit”: 10000, “pagination”: { “page”: 1, “per_page”: 10, “total_entries”: 1339, “total_pages”: 134 }, “contacts”: [], “people”: [ { “id”: “618a24XXXXXXXXXXXXXXXXXX”, “first_name”: “Tim”, “last_name”: “Zheng”, “name”: “Tim Zheng”, “linkedin_url”: “http://www.linkedin.com/in/tim-zheng-677ba010”, “title”: “Founder & CEO”, “email_status”: “verified”, “photo_url”: “https://static-exp1.licdn.com/sc/h/244xhbkr7g40x6bsu4gi6q4ry”, “twitter_url”: null, “github_url”: null, “facebook_url”: null, “extrapolated_email_confidence”: null, “headline”: “Founder & CEO at Apollo”, “email”: “[email protected]”, “employment_history”: [ { “_id”: “618afbXXXXXXXXXXXXXXXXXX”, “created_at”: “2021-11-09T22:51:18.531Z”, “current”: true, “degree”: null, “description”: null, “emails”: null, “end_date”: null, “grade_level”: null, “kind”: null, “major”: null, “organization_id”: “5e66b6XXXXXXXXXXXXXXXXXX”, “organization_name”: “Apollo”, “raw_address”: null, “start_date”: “2015-01-01”, “title”: “Founder & CEO”, “updated_at”: “2021-11-09T22:51:18.531Z”, “id”: “618afbXXXXXXXXXXXXXXXXXX”, “key”: “618afbXXXXXXXXXXXXXXXXXX” }, { “_id”: “618afbXXXXXXXXXXXXXXXXXX”, “created_at”: “2021-11-09T22:51:18.536Z”, “current”: false, “degree”: null, “description”: null, “emails”: null, “end_date”: “2014-01-01”, “grade_level”: null, “kind”: null, “major”: null, “organization_id”: null, “organization_name”: “Braingenie”, “raw_address”: null, “start_date”: “2011-01-01”, “title”: “Founder & CEO”, “updated_at”: “2021-11-09T22:51:18.536Z”, “id”: “618afbXXXXXXXXXXXXXXXXXX”, “key”: “618afbXXXXXXXXXXXXXXXXXX” }, { “_id”: “618afbXXXXXXXXXXXXXXXXXX”, “created_at”: “2021-11-09T22:51:18.536Z”, “current”: false, “degree”: null, “description”: null, “emails”: null, “end_date”: “2011-01-01”, “grade_level”: null, “kind”: null, “major”: null, “organization_id”: “54a22fXXXXXXXXXXXXXXXXXX”, “organization_name”: “Citadel Investment Group”, “raw_address”: null, “start_date”: “2011-01-01”, “title”: “Investment & Trading Associate”, “updated_at”: “2021-11-09T22:51:18.536Z”, “id”: “618afbXXXXXXXXXXXXXXXXXX”, “key”: “618afbXXXXXXXXXXXXXXXXXX” } ], “state”: “Texas”, “city”: “Austin”, “country”: “United States”, “organization_id”: “5e66b6XXXXXXXXXXXXXXXXXX”, “organization”: { “id”: “5e66b6XXXXXXXXXXXXXXXXXX”, “name”: “Apollo.io”, “website_url”: “http://www.apollo.io”, “blog_url”: null, “angellist_url”: null, “linkedin_url”: “http://www.linkedin.com/company/apolloio”, “twitter_url”: “https://twitter.com/MeetApollo/”, “facebook_url”: “https://www.facebook.com/MeetApollo/”, “primary_phone”: { “number”: “(202) 374-XXXX”, “source”: “Account” }, “languages”: [], “alexa_ranking”: 685, “phone”: “(202) 374-XXXX”, “linkedin_uid”: “185115XX”, “founded_year”: 2015, “publicly_traded_symbol”: null, “publicly_traded_exchange”: null, “logo_url”: “https://apollo-server.com/uploads/pictures/6188cXXXXXXXXXXXXXXXXXXX/picture”, “crunchbase_url”: null, “primary_domain”: “apollo.io”, “persona_counts”: {} }, “account_id”: “616d0eXXXXXXXXXXXXXXXXXX”, “account”: { “id”: “616d0eXXXXXXXXXXXXXXXXXX”, “name”: “Apollo”, “website_url”: “http://www.apollo.io”, “blog_url”: null, “angellist_url”: null, “linkedin_url”: “http://www.linkedin.com/company/apolloio”, “twitter_url”: “https://twitter.com/MeetApollo/”, “facebook_url”: “https://www.facebook.com/MeetApollo/”, “primary_phone”: { “number”: “(202) 374-XXXX”, “source”: “Account” }, “languages”: [], “alexa_ranking”: 685, “phone”: “(123) 456-XXXX”, “linkedin_uid”: “185115XX”, “founded_year”: 2015, “publicly_traded_symbol”: null, “publicly_traded_exchange”: null, “logo_url”: “https://apollo-server.com/uploads/pictures/6188cXXXXXXXXXXXXXXXXXXX/picture”, “crunchbase_url”: null, “primary_domain”: “apollo.io”, “persona_counts”: {}, “domain”: “apollo.io”, “team_id”: “5c1004a041f5ac0995d5f5e8”, “organization_id”: “5e66b6XXXXXXXXXXXXXXXXXX”, “account_stage_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “source”: “crm”, “original_source”: “crm”, “owner_id”: null, “created_at”: “2021-10-18T06:03:45.774Z”, “phone_status”: “no_status”, “test_predictive_score”: null, “hubspot_id”: “699261XXXX”, “salesforce_id”: null, “crm_owner_id”: “511281XX”, “parent_account_id”: null, “sanitized_phone”: “+112345XXXXX”, “account_playbook_statuses”: [], “existence_level”: “full”, “label_ids”: [], “typed_custom_fields”: {}, “modality”: “account”, “hubspot_record_url”: “https://app.hubspot.com/sales/25200013/company/699261XXXX”, “salesloft_id”: “233684XX”, “salesloft_url”: “https://app.salesloft.com/app/company/233684XX” } } ] }

This endpoint searches for people. Calls to the search endpoint do not cost you credits. They also do not return any email information. To get email information, use the “enrich” endpoint.

POST https://api.apollo.io/v1/mixed_people/search

Query Parameters

Parameter	Description	Example
person_titles (optional)	an array of the person’s title. Apollo will return results matching ANY of the titles passed in	[“sales director”, “engineer manager”]
q_organization_domains (optional)	an array of the company domains to search for, joined by the new line character.	“google.comnfacebook.com”
page (optional)	an integer that allows you to paginate through the results	1

Return Results

“people” are people in Apollo’s database. “contacts” are people already in your linked CRM.

An Organization represents a company in Apollo’s database.

Organization Jobs Postings

curl -X GET -H “Content-Type: application/json” -H “Cache-Control: no-cache” “https://api.apollo.io/v1/organizations/ORGANIZATION_ID/job_postings?api_key=YOUR_API_KEY_HERE” import requests url = “https://api.apollo.io/v1/organizations/ORGANIZATION_ID/job_postings” querystring = { “api_key”: “YOUR API KEY HERE” } headers = { ‘Cache-Control’: ‘no-cache’, ‘Content-Type’: ‘application/json’ } response = requests.request(“GET”, url, headers=headers, params=querystring) print(response.text)

{ “organization_job_postings”: [ { “id”: “5ed76XXXXXXXXXXXXXXXX”, “title”: “Product Marketing Manager, Security”, “url”: “https://www.linkedin.com/jobs/view/product-marketing-manager-security-at-google-1878106711?refId=e19c8d31-7452-4bfc-8097-66ab00fe06a8&position=14&pageNum=9&trk=public_jobs_job-result-card_result-card_full-click”, “city”: “San Francisco”, “state”: “California”, “country”: “United States”, “last_seen_at”: “2020-06-03T09:09:57.751+00:00”, “posted_at”: “2020-06-03T07:09:57.751+00:00” }, { “id”: “5ed768XXXXXXXXXXXXXXXX”, “title”: “Product Marketing Manager, Security”, “url”: “https://www.linkedin.com/jobs/view/product-marketing-manager-security-at-google-1878108613?refId=e19c8d31-7452-4bfc-8097-66ab00fe06a8&position=17&pageNum=9&trk=public_jobs_job-result-card_result-card_full-click”, “city”: “Sunnyvale”, “state”: “California”, “country”: “United States”, “last_seen_at”: “2020-06-03T09:09:57.754+00:00”, “posted_at”: “2020-06-03T07:09:57.754+00:00” }, { “id”: “5ed768XXXXXXXXXXXXXXXX”, “title”: “Staff Software Engineer, Platforms, Google Cloud”, “url”: “https://www.linkedin.com/jobs/view/staff-software-engineer-platforms-google-cloud-at-google-1878104847?refId=e19c8d31-7452-4bfc-8097-66ab00fe06a8&position=18&pageNum=9&trk=public_jobs_job-result-card_result-card_full-click”, “city”: “Sunnyvale”, “state”: “California”, “country”: “United States”, “last_seen_at”: “2020-06-03T09:09:57.755+00:00”, “posted_at”: “2020-07-30T07:32:24.298+00:00” } ] }

Get a list of active job postings for a company.

GET https://api.apollo.io/v1/organizations/ORGANIZATION_ID/job_postings

Query Parameters

Parameter	Description	Example
id	The id of the organization (i.e. NOT account id). You can obtain this with a company’s domain by using the enrich endpoint.	54fca1087369647fcXXXXXXX

Opportunities are records that you can use to track possible deals with your prospective customers. Opportunities can be associated with both companies and people in Apollo.

Create Opportunity

curl -X POST -H “Content-Type: application/json” -H “Cache-Control: no-cache” -d ‘{ “api_key”: “YOUR API KEY HERE”, “owner_id”:”5c10XXXXXXXXXXXXXXXXXXXX”, “name”:”Opportunity Name”, “amount”:”200″, “opportunity_stage_id”:”5c14XXXXXXXXXXXXXXXXXXXX”, “closed_date”:”2020-12-18″, “account_id”:”5f06XXXXXXXXXXXXXXXXXXXX” }’ “https://app.apollo.io/api/v1/opportunities” import requests url = “https://app.apollo.io/api/v1/opportunities” data = { “api_key”: “YOUR API KEY HERE”, “owner_id”:”5c10XXXXXXXXXXXXXXXXXXXX”, “name”:”Opportunity Name”, “amount”:”200″, “opportunity_stage_id”:”5c14XXXXXXXXXXXXXXXXXXXX”, “closed_date”:”2020-12-18″, “account_id”:”5f06XXXXXXXXXXXXXXXXXXXX” } headers = { ‘Cache-Control’: ‘no-cache’, ‘Content-Type’: ‘application/json’ } response = requests.request(“POST”, url, headers=headers, json=data) print(response.text)

{ “opportunity”: { “id”: “5fdcXXXXXXXXXXXXXXXXXXXX”, “team_id”: “5c10XXXXXXXXXXXXXXXXXXXX”, “owner_id”: “5c10XXXXXXXXXXXXXXXXXXXX”, “salesforce_owner_id”: null, “amount”: 200.0, “closed_date”: “2020-12-18T00:00:00.000+00:00”, “account_id”: “5f06XXXXXXXXXXXXXXXXXXXX”, “description”: null, “is_closed”: null, “is_won”: null, “name”: “Opportunity Name”, “stage_name”: null, “opportunity_stage_id”: “5c14XXXXXXXXXXXXXXXXXXXX”, “salesforce_id”: null, “created_at”: “2020-12-18T10:41:54.591Z”, “existence_level”: “none”, “opportunity_contact_roles”: [] } }

POST https://api.apollo.io/v1/opportunities

Parameter	Description
owner_id	Owner ID . You can GET a list of possible users and their associated information from Misc/Users
name	Opportunity Name
amount	The Amount of money involved in the Opportunity/ Deal
opportunity_stage_id	The ID of the current Stage .You can get a list of all opportunity stages from Misc/Opportunity Stages
closed_date	The date the Opportunity was closed
account_id	ID of the Account

Get all Opportunities

curl -X GET -H “Content-Type: application/json” -H “Cache-Control: no-cache” “https://api.apollo.io/v1/opportunities/search?api_key=YOUR_API_KEY_HERE” import requests url = “https://api.apollo.io/v1/opportunities/search” querystring = { “api_key”: “YOUR API KEY HERE” } headers = { ‘Cache-Control’: ‘no-cache’, ‘Content-Type’: ‘application/json’ } response = requests.request(“GET”, url, headers=headers, params=querystring) print(response.text)

{ “breadcrumbs”: [], “opportunities”: [ { “id”: “5c14XXXXXXXXXXXXXXXXXXXX”, “team_id”: “5c10XXXXXXXXXXXXXXXXXXXX”, “owner_id”: “5c100XXXXXXXXXXXXXXXXXXXX”, “salesforce_owner_id”: “0051U000XXXXXXXXXX”, “amount”: 90000.0, “closed_date”: “2018-08-27T15:00:00.000+00:00”, “account_id”: “5c14XXXXXXXXXXXXXXXXXXXX”, “description”: null, “is_closed”: true, “is_won”: true, “name”: “Apollo Inc”, “stage_name”: “Closed Won”, “opportunity_stage_id”: “5c10XXXXXXXXXXXXXXXXXXXX”, “typed_custom_fields”: { “5c10XXXXXXXXXXXXXXXXXXXX”: [], “5c10XXXXXXXXXXXXXXXXXXXXX”: [ “5c14XXXXXXXXXXXXXXXXXXXX” ] }, “source”: “crm”, “salesforce_id”: “0061U000XXXXXXXXXX”, “created_at”: “2018-12-14T21:36:02.191Z”, “existence_level”: “full”, “opportunity_contact_roles”: [], “salesforce_record_url”: “https://na85.salesforce.com/0061U000XXXXXXXXXX”, “account”: { “id”: “5c14XXXXXXXXXXXXXXXXXXXX”, “domain”: “apollo.io”, “name”: “Apollo Inc”, “team_id”: “5c10XXXXXXXXXXXXXXXXXXXX”, “typed_custom_fields”: {}, “organization_id”: null, “account_stage_id”: “5c10XXXXXXXXXXXXXXXXXXXX”, “source”: “csv_import”, “original_source”: “salesforce”, “owner_id”: “5c10XXXXXXXXXXXXXXXXXXXX”, “created_at”: “2018-12-14T21:35:57.141Z”, “phone”: “(312) 596-1000”, “phone_status”: “no_status”, “test_predictive_score”: null, “hubspot_id”: null, “salesforce_id”: “0011U000XXXXXXXXXX”, “crm_owner_id”: “0051U000XXXXXXXXXX”, “parent_account_id”: null, “sanitized_phone”: “+1312XXXXXXX”, “account_playbook_statuses”: [], “existence_level”: “full”, “label_ids”: [], “modality”: “account”, “salesforce_record_url”: “https://na85.salesforce.com/0011U000XXXXXXXXXX”, “contact_emailer_campaign_ids”: [], “contact_campaign_status_tally”: {}, “num_contacts”: 0, “last_activity_date”: null, “persona_counts”: {} } }, { “id”: “5e1fXXXXXXXXXXXXXXXXXXXX”, “team_id”: “5c10XXXXXXXXXXXXXXXXXXXX”, “owner_id”: “5c10XXXXXXXXXXXXXXXXXXXX”, “salesforce_owner_id”: “0051U000XXXXXXXXXX”, “amount”: 10.0, “closed_date”: “2020-01-31T16:00:00.000+00:00”, “account_id”: “5c14XXXXXXXXXXXXXXXXXXXX”, “description”: null, “is_closed”: false, “is_won”: false, “name”: “Sample Opportunity”, “stage_name”: “Qualification”, “opportunity_stage_id”: “5c14XXXXXXXXXXXXXXXXXXXX”, “typed_custom_fields”: {}, “source”: “crm”, “salesforce_id”: “0061U000XXXXXXXXXX”, “created_at”: “2020-01-16T00:41:30.834Z”, “existence_level”: “full”, “opportunity_contact_roles”: [], “salesforce_record_url”: “https://na85.salesforce.com/0061U000XXXXXXXXXX”, “account”: { “id”: “5c14XXXXXXXXXXXXXXXXXXXX”, “domain”: “apollooportunity.com”, “name”: “Apollo Oportunity Limited”, “team_id”: “5c10XXXXXXXXXXXXXXXXXXXX”, “typed_custom_fields”: {}, “organization_id”: null, “account_stage_id”: “5c100XXXXXXXXXXXXXXXXXXXX”, “source”: “salesforce”, “original_source”: “salesforce”, “owner_id”: “5c10XXXXXXXXXXXXXXXXXXXX”, “created_at”: “2018-12-14T21:35:57.141Z”, “phone”: “(512) 757-6000”, “phone_status”: “no_status”, “test_predictive_score”: null, “hubspot_id”: null, “salesforce_id”: “0011U000XXXXXXXXXX”, “crm_owner_id”: “0051U000XXXXXXXXXX”, “parent_account_id”: null, “sanitized_phone”: “+1512XXXXXXX”, “account_playbook_statuses”: [], “existence_level”: “full”, “label_ids”: [], “modality”: “account”, “salesforce_record_url”: “https://na85.salesforce.com/0011U000XXXXXXXXXX”, “contact_emailer_campaign_ids”: [], “contact_campaign_status_tally”: {}, “num_contacts”: 0, “last_activity_date”: null, “persona_counts”: {} } } ]

This endpoint returns all opportunities you have Created.

GET https://api.apollo.io/v1/opportunities

View Opportunity

curl -X GET -H “Content-Type: application/json” -H “Cache-Control: no-cache” “https://api.apollo.io/v1/opportunities/REPLACE_WITH_OPPORTUNITY_ID?api_key=YOUR_API_KEY_HERE” import requests url = “https://api.apollo.io/v1/opportunities/REPLACE_WITH_OPPORTUNITY_ID” querystring = { “api_key”: “YOUR API KEY HERE” } headers = { ‘Cache-Control’: ‘no-cache’, ‘Content-Type’: ‘application/json’ } response = requests.request(“GET”, url, headers=headers, params=querystring) print(response.text)

{ “opportunity”: { “id”: “5c14XXXXXXXXXXXXXXXXXXXX”, “team_id”: “5c10XXXXXXXXXXXXXXXXXXXX”, “owner_id”: “5c10XXXXXXXXXXXXXXXXXXXX”, “salesforce_owner_id”: “0051U000001FAqXQAW”, “amount”: 90000.0, “closed_date”: “2018-08-27T15:00:00.000+00:00”, “account_id”: “5c14XXXXXXXXXXXXXXXXXXXX”, “description”: null, “is_closed”: true, “is_won”: true, “name”: “Grand Apollo SLA”, “stage_name”: “Closed Won”, “opportunity_stage_id”: “5c10XXXXXXXXXXXXXXXXXXXX”, “source”: “crm”, “salesforce_id”: “0061U000XXXXXXXXXX”, “created_at”: “2018-12-14T21:36:02.191Z”, “existence_level”: “full”, “opportunity_contact_roles”: [], “salesforce_record_url”: “https://na85.salesforce.com/0061U000XXXXXXXXXX”, “num_contacts”: 0 } }

This endpoint returns the full information about an opportunity.

You can GET a list of all created Opportunities from Opportunities/all

GET https://api.apollo.io/v1/opportunities/REPLACE_WITH_OPPORTUNITY_ID

Update Opportunity

curl -X PATCH -H “Content-Type: application/json” -H “Cache-Control: no-cache” -d ‘{ “api_key”: “YOUR API KEY HERE”, “name”: “Opportunity Name Updated”, }’ “https://api.apollo.io/v1/opportunities” import requests url = “https://api.apollo.io/v1/opportunities” data = { “api_key”: “YOUR API KEY HERE”, “name”: “Opportunity Name Updated”, } headers = { ‘Cache-Control’: ‘no-cache’, ‘Content-Type’: ‘application/json’ } response = requests.patch(url, headers=headers, data=data) print(response.text)

{ “opportunity”: { “id”: “5c14XXXXXXXXXXXXXXXXXXXX”, “team_id”: “5c10XXXXXXXXXXXXXXXXXXXX”, “owner_id”: “5c10XXXXXXXXXXXXXXXXXXXX”, “salesforce_owner_id”: “0051U000001FAqXQAW”, “amount”: 90000.0, “closed_date”: “2018-08-27T15:00:00.000+00:00”, “account_id”: “5c14XXXXXXXXXXXXXXXXXXXX”, “description”: null, “is_closed”: true, “is_won”: true, “name”: “Opportunity Name Updated”, “stage_name”: “Closed Won”, “opportunity_stage_id”: “5c10XXXXXXXXXXXXXXXXXXXX”, “source”: “crm”, “salesforce_id”: “0061U000XXXXXXXXXX”, “created_at”: “2018-12-14T21:36:02.191Z”, “existence_level”: “full”, “opportunity_contact_roles”: [], “salesforce_record_url”: “https://na85.salesforce.com/0061U000XXXXXXXXXX”, “num_contacts”: 0 } }

Update the details of an already existing opportunity.

Only supplied fields will be updated. All other fields will be left untouched.

You can GET a list of all created Opportunities from Opportunities/all

PATCH https://api.apollo.io/v1/opportunities/REPLACE_WITH_OPPORTUNITY_ID

A Contact is a person your team has explicitly added to your database. It can be from prospected from Apollo, manually added by your team, or created by the API.

curl -X POST -H “Content-Type: application/json” -H “Cache-Control: no-cache” -d ‘{ “api_key”: “YOUR API KEY HERE”, “first_name”: “Jon”, “last_name”: “Snow”, “title”: “Lord Commander”, “organization_name”: “Westeros” }’ “https://api.apollo.io/v1/contacts” import requests url = “https://api.apollo.io/v1/contacts” data = { “api_key”: “YOUR API KEY HERE”, “first_name”: “Jonny”, “last_name”: “Snow”, “title”: “Lord Commander”, “organization_name”: “Apollo”, } headers = { ‘Cache-Control’: ‘no-cache’, ‘Content-Type’: ‘application/json’ } response = requests.request(“POST”, url, headers=headers, json=data) print(response.text)

{ “contact”: { “id”: “5f34e4XXXXXXXXXXXXXXXXXX”, “first_name”: “Jon”, “last_name”: “Snow”, “name”: “Jon Snow”, “linkedin_url”: null, “title”: “Lord Commander”, “contact_stage_id”: “5c48fb3XXXXXXXXXXXXXXXXXX”, “owner_id”: “5cc77dXXXXXXXXXXXXXXXXXX”, “person_id”: null, “email_needs_tickling”: false, “organization_name”: “Westeros”, “source”: “api”, “original_source”: “api”, “organization_id”: null, “headline”: null, “photo_url”: null, “present_raw_address”: null, “linkedin_uid”: null, “extrapolated_email_confidence”: 0, “salesforce_id”: null, “salesforce_lead_id”: null, “salesforce_contact_id”: null, “salesforce_account_id”: null, “salesforce_owner_id”: null, “created_at”: “2020-08-13T06:56:09.789Z”, “lead_request_id”: null, “test_predictive_score”: null, “emailer_campaign_ids”: [], “email_manually_changed”: false, “direct_dial_status”: null, “direct_dial_enrichment_failed_at”: null, “email_status”: null, “account_id”: null, “last_activity_date”: null, “hubspot_vid”: null, “hubspot_company_id”: null, “sanitized_phone”: null, “merged_crm_ids”: [], “typed_custom_fields”: {}, “updated_at”: “2020-08-13T06:56:09.789Z”, “queued_for_crm_push”: true, “starred_by_user_ids”: [], “suggested_from_rule_engine_config_id”: null, “label_ids”: [], “has_pending_email_arcgate_request”: false, “has_email_arcgate_request”: false, “existence_level”: “full”, “email”: null, “contact_campaign_statuses”: [], “next_contact_id”: null, “time_zone”: null, “city”: null, “state”: null, “country”: null, “phone_numbers”: [], “account_phone_note”: null }, “labels”: [], “team”: { “id”: “5c1004XXXXXXXXXXXXXXXXXX”, “contacts_finder_empty”: false } }

POST https://api.apollo.io/v1/contacts

Apollo does not run any deduplication during CREATE. If your record contains the same email or name+company as an existing contact, Apollo will create a new contact instead of updating the existing contact.

Parameter	Description	Example
first_name	First name	“Jon”
last_name	Last Name	“Snow”
organization_name	Company Name	“Westeros Inc.”
title	Title	“Lord Commander”
account_id	ID of the Account (Optional)	“583f2f7ed9ced98ab5bfXXXX”
email	Email. Invalid emails will be ignored.	“[email protected]”
website_url	The organization website Apollo can use to enrich data for you. DO NOT pass in personal social media URLs such as “http://www.linkedin.com/profile_url”, or your data will be incorrectly enriched. This argument will be ignored if you pass in a valid email.	“http://www.westeros.com”
label_names	A list of names to tag this newly created contact. If the name does not exist, Apollo will automatically create it	[“inbound contact”, “smb clients”]
contact_stage_id	Assign contact to this stage, if the contact does not yet exist. Get a list of possible stage ids with GET /contact_stages	“583f2f7ed9ced98ab5bfXXXX”
present_raw_address	The address string for this contact, Apollo will intelligently infer the city, state, country, and time zone from your address	“San Francisco”

curl -X PUT -H “Content-Type: application/json” -H “Cache-Control: no-cache” -d ‘{ “api_key”: “YOUR API KEY HERE”, “first_name”: “Jon”, “last_name”: “Snow”, “email”: “[email protected]”, “title”: “Lord Commander”, “organization_name”: “Westeros” }’ “https://api.apollo.io/v1/contacts/YOUR CONTACT ID” import requests url = “https://api.apollo.io/v1/contacts/YOUR CONTACT ID” data = { “api_key”: “YOUR API KEY HERE”, “first_name”: “Jon”, “last_name”: “Snow”, “email”: “[email protected]”, “title”: “Lord Commander”, “organization_name”: “Westeros” } headers = { ‘Cache-Control’: ‘no-cache’, ‘Content-Type’: ‘application/json’ } response = requests.request(“PUT”, url, headers=headers, json=data) print(response.text)

{ “contact”: { “id”: “5f34e4XXXXXXXXXXXXXXXXXX”, “first_name”: “Jon”, “last_name”: “Snow”, “name”: “Jon Snow”, “linkedin_url”: null, “title”: “Lord Commander”, “contact_stage_id”: “5c48fbXXXXXXXXXXXXXXXXXX”, “owner_id”: “5cc77dXXXXXXXXXXXXXXXXXX”, “person_id”: null, “email_needs_tickling”: false, “organization_name”: “Westeros”, “source”: “api”, “original_source”: “api”, “organization_id”: null, “headline”: null, “photo_url”: null, “present_raw_address”: null, “linkedin_uid”: null, “extrapolated_email_confidence”: 0, “salesforce_id”: null, “salesforce_lead_id”: null, “salesforce_contact_id”: null, “salesforce_account_id”: null, “salesforce_owner_id”: null, “created_at”: “2020-08-13T06:56:09.789Z”, “lead_request_id”: null, “test_predictive_score”: null, “emailer_campaign_ids”: [], “email_manually_changed”: true, “direct_dial_status”: null, “direct_dial_enrichment_failed_at”: null, “email_status”: “verified”, “account_id”: null, “last_activity_date”: null, “hubspot_vid”: null, “hubspot_company_id”: null, “sanitized_phone”: null, “merged_crm_ids”: [], “typed_custom_fields”: {}, “updated_at”: “2020-08-13T07:21:10.336Z”, “queued_for_crm_push”: false, “starred_by_user_ids”: [], “suggested_from_rule_engine_config_id”: null, “label_ids”: [], “has_pending_email_arcgate_request”: false, “has_email_arcgate_request”: false, “existence_level”: “full”, “email”: “[email protected]”, “next_contact_id”: null, “time_zone”: null, “city”: null, “state”: null, “country”: null, “crm_job”: { “id”: “5f34e6XXXXXXXXXXXXXXXXXX”, “note”: “storage limit exceeded”, “job_type”: “push_contacts”, “retry_at”: “2020-08-13T07:17:19.707+00:00”, “status”: “failed”, “created_at”: “2020-08-13T07:07:19.696Z” }, “phone_numbers”: [], “account_phone_note”: null }, “labels”: [] }

PUT https://api.apollo.io/v1/contacts

Do not pass in contact_stage_id in this endpoint. Use contacts/update_stages instead.

Parameter	Description	Example
id (Required)	Contact ID	“583f2f7ed9ced98ab5bfXXXX”
first_name	First name	“Jon”
last_name	Last Name	“Snow”
organization_name	Company Name	“Westeros Inc.”
title	Title	“Lord Commander”
account_id	ID of the Account (Optional)	“583f2f7ed9ced98ab5bfXXXX”
email	Email	“[email protected]”
label_names	A list of names to tag this contact. If the name does not exist, Apollo will automatically create it	[“inbound contact”, “smb clients”]
present_raw_address	The address string for this contact, Apollo will intelligently infer the city, state, and country from your address	“San Francisco”
direct_phone	The direct dial phone for this contact. If the contact already has a direct dial, this overwrites it. If a contact does not already have a direct dial, this ADDS a new direct dial on top of existing phone numbers	“123-456-7890”
corporate_phone	The corporate phone for this contact. If the contact already has a corporate phone, this overwrites it. If a contact does not already have a corporate phone, this ADDS a new corporate phone on top of existing phone numbers	“123-456-7890”
mobile_phone	The mobile phone for this contact. If the contact already has a mobile phone, this overwrites it. If a contact does not already have a mobile phone, this ADDS a new mobile phone on top of existing phone numbers	“123-456-7890”
home_phone	The home phone for this contact. If the contact already has a home phone, this overwrites it. If a contact does not already have a home phone, this ADDS a new home phone on top of existing phone numbers	“123-456-7890”
other_phone	Phone of unknown type for this contact. If the contact already has phone of unknown type, this overwrites it. If a contact does not already have phone of unknown type, this ADDS a new phone on top of existing phone numbers	“123-456-7890”

curl -X POST -H “Content-Type: application/json” -H “Cache-Control: no-cache” -d ‘{ “api_key”: “YOUR API KEY HERE”, “q_keywords”: “Tim Zheng, CEO, Apollo”, “sort_by_field”: “contact_last_activity_date”, “sort_ascending”: false }’ “https://api.apollo.io/v1/contacts/search” import requests url = “https://api.apollo.io/v1/contacts/search” data = { “api_key”: “YOUR API KEY HERE”, “q_keywords”: “Tim Zheng, CEO, Apollo”, “sort_by_field”: “contact_last_activity_date”, “sort_ascending”: False, } headers = { ‘Cache-Control’: ‘no-cache’, ‘Content-Type’: ‘application/json’ } response = requests.request(“POST”, url, headers=headers, json=data) print(response.text)

{ “contacts”: [ { “id”: “5da8ceXXXXXXXXXXXXXXXXXX”, “first_name”: “Tim”, “last_name”: “Zheng”, “name”: “Tim Zheng”, “linkedin_url”: “http://www.linkedin.com/in/tim-zheng-677ba010”, “title”: “Founder & CEO”, “contact_stage_id”: “5c48fbXXXXXXXXXXXXXXXXXX”, “owner_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “person_id”: “5f2b88XXXXXXXXXXXXXXXXXX”, “email_needs_tickling”: false, “organization_name”: “Apollo”, “source”: “search”, “original_source”: “email_import”, “organization_id”: “5e66b6XXXXXXXXXXXXXXXXXX”, “headline”: “Founder & CEO at Apollo”, “photo_url”: “https://some-url.fyvrk”, “present_raw_address”: “San Francisco, California, United States”, “linkedin_uid”: “38777275”, “extrapolated_email_confidence”: 0, “salesforce_id”: “0031UXXXXXXXXXXXXXX”, “salesforce_lead_id”: null, “salesforce_contact_id”: “0031UXXXXXXXXXXXXXXX”, “salesforce_account_id”: “0011UXXXXXXXXXXXXXXX”, “salesforce_owner_id”: “0051UXXXXXXXXXXXXXXX”, “created_at”: “2019-10-17T20:25:07.594Z”, “lead_request_id”: null, “test_predictive_score”: null, “emailer_campaign_ids”: [], “email_manually_changed”: false, “direct_dial_status”: null, “direct_dial_enrichment_failed_at”: null, “email_status”: “verified”, “account_id”: “5f1fadXXXXXXXXXXXXXXXXXX”, “last_activity_date”: “2018-06-26T16:30:35.000+00:00”, “hubspot_vid”: null, “hubspot_company_id”: null, “sanitized_phone”: null, “merged_crm_ids”: [], “typed_custom_fields”: { “5d856eXXXXXXXXXXXXXXXXXX”: “Tim Zheng” }, “updated_at”: “2020-07-28T04:44:51.448Z”, “queued_for_crm_push”: false, “starred_by_user_ids”: [], “suggested_from_rule_engine_config_id”: null, “label_ids”: [], “has_pending_email_arcgate_request”: false, “has_email_arcgate_request”: false, “existence_level”: “full”, “email”: “[email protected]”, “salesforce_record_url”: “https://na85.salesforce.com/0031UXXXXXXXXXXXXXXXXXX”, “contact_campaign_statuses”: [], “state”: “California”, “city”: “San Francisco”, “country”: “United States”, “account”: { “id”: “5f1fadXXXXXXXXXXXXXXXXXX”, “name”: “Apollo”, “website_url”: “http://www.apollo.io”, “blog_url”: null, “angellist_url”: null, “linkedin_url”: “http://www.linkedin.com/company/apolloio”, “twitter_url”: “https://twitter.com/MeetApollo/”, “facebook_url”: “https://www.facebook.com/MeetApollo/”, “languages”: [], “alexa_ranking”: 77520, “phone”: null, “linkedin_uid”: “18511550”, “publicly_traded_symbol”: null, “publicly_traded_exchange”: null, “logo_url”: “https://apollo-server.com/uploads/pictures/5f0265XXXXXXXXXXXXXXXXXX/picture”, “crunchbase_url”: null, “primary_domain”: “apollo.io”, “starred_by_user_ids”: [], “persona_counts”: {}, “domain”: “apollo.io”, “team_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “typed_custom_fields”: {}, “organization_id”: “5e66b6XXXXXXXXXXXXXXXXXX”, “account_stage_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “source”: “salesforce”, “original_source”: “salesforce”, “owner_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “created_at”: “2020-07-28T04:44:13.821Z”, “phone_status”: “no_status”, “test_predictive_score”: null, “hubspot_id”: null, “salesforce_id”: “0011UXXXXXXXXXX”, “salesforce_owner_id”: “0051UXXXXXXXXXX”, “parent_account_id”: null, “account_playbook_statuses”: [], “existence_level”: “full”, “label_ids”: [], “modality”: “account”, “salesforce_record_url”: “https://na85.salesforce.com/0011UXXXXXXXXXXX” }, “organization”: { “id”: “5e66b6XXXXXXXXXXXXXXXXXX”, “name”: “Apollo”, “website_url”: “http://www.apollo.io”, “blog_url”: null, “angellist_url”: null, “linkedin_url”: “http://www.linkedin.com/company/apolloio”, “twitter_url”: “https://twitter.com/MeetApollo/”, “facebook_url”: “https://www.facebook.com/MeetApollo/”, “languages”: [], “alexa_ranking”: 77520, “phone”: null, “linkedin_uid”: “18511550”, “publicly_traded_symbol”: null, “publicly_traded_exchange”: null, “logo_url”: “https://apollo-server.com/uploads/pictures/5f0265XXXXXXXXXXXXXXXXXX/picture”, “crunchbase_url”: null, “primary_domain”: “apollo.io”, “starred_by_user_ids”: [], “persona_counts”: {} }, “phone_numbers”: [], “account_phone_note”: null, “contact_job_change_event”: null } ], “breadcrumbs”: [ { “label”: “Contains Keywords”, “signal_field_name”: “q_keywords”, “value”: “Tim Zheng, CEO, Apollo”, “display_name”: “Tim Zheng, CEO, Apollo” } ], “partial_results_only”: false, “disable_eu_prospecting”: false, “partial_results_limit”: 10000, “pagination”: { “page”: 1, “per_page”: 25, “total_entries”: 1, “total_pages”: 1 }, “num_fetch_result”: null }

POST https://api.apollo.io/v1/contacts/search

Parameter	Description
q_keywords	The contact’s name, title, company, or email
contact_stage_ids	An array of stage ids the contact must belong to. Refer to /contact_stages to get a list of possible stage ids.
sort_by_field	Possible values: “contact_last_activity_date”, “contact_email_last_opened_at”, “contact_email_last_clicked_at”, “contact_created_at”, or “contact_updated_at”
sort_ascending	Possible values: true or false
page	which page to return. Defaults to 1
per_page	how many contacts to return per page. Max = 200

curl -X GET -H “Content-Type: application/json” -H “Cache-Control: no-cache” “https://api.apollo.io/v1/contact_stages?api_key=YOUR_API_KEY_HERE” import requests url = “https://api.apollo.io/v1/contact_stages” querystring = { “api_key”: “YOUR API KEY HERE” } headers = { ‘Cache-Control’: ‘no-cache’, ‘Content-Type’: ‘application/json’ } response = requests.request(“GET”, url, headers=headers, params=querystring) print(response.text)

{ “contact_stages”: [ { “id”: “5c48fbXXXXXXXXXXXXXXXXXX”, “team_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “display_name”: “Cold”, “name”: “Cold”, “display_order”: 0, “ignore_trigger_override”: false, “category”: “in_progress” }, { “id”: “5c1004XXXXXXXXXXXXXXXXXX”, “team_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “display_name”: “Approaching”, “name”: “Approaching”, “display_order”: 1, “ignore_trigger_override”: null, “category”: “in_progress” }, { “id”: “5c1004XXXXXXXXXXXXXXXXXX”, “team_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “display_name”: “Replied”, “name”: “Replied”, “display_order”: 2, “ignore_trigger_override”: null, “category”: “in_progress” }, { “id”: “5c1004XXXXXXXXXXXXXXXXXX”, “team_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “display_name”: “Interested”, “name”: “Interested”, “display_order”: 3, “ignore_trigger_override”: true, “category”: “succeeded” }, { “id”: “5c1004XXXXXXXXXXXXXXXXXX”, “team_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “display_name”: “Not Interested”, “name”: “Not Interested”, “display_order”: 4, “ignore_trigger_override”: true, “category”: “failed” }, { “id”: “5c1004XXXXXXXXXXXXXXXXXX”, “team_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “display_name”: “Unresponsive”, “name”: “Unresponsive”, “display_order”: 5, “ignore_trigger_override”: null, “category”: “failed” }, { “id”: “5c1004XXXXXXXXXXXXXXXXXX”, “team_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “display_name”: “Do Not Contact”, “name”: “Do Not Contact”, “display_order”: 6, “ignore_trigger_override”: true, “category”: “failed” }, { “id”: “5c1004XXXXXXXXXXXXXXXXXX”, “team_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “display_name”: “Bad Data”, “name”: “Bad Data”, “display_order”: 7, “ignore_trigger_override”: null, “category”: null }, { “id”: “5c1004XXXXXXXXXXXXXXXXXX”, “team_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “display_name”: “Changed Job”, “name”: “Changed Job”, “display_order”: 8, “ignore_trigger_override”: true, “category”: null } ] }

GET https://api.apollo.io/v1/contact_stages

curl -X POST -H “Content-Type: application/json” -H “Cache-Control: no-cache” -d ‘{ “api_key”: “YOUR API KEY HERE”, “contact_ids”: [“contact_id1”, “contact_id2”], “contact_stage_id”: “stage_id” }’ “https://api.apollo.io/v1/contacts/update_stages” import requests url = “https://api.apollo.io/v1/contacts/update_stages” data = { “api_key”: “YOUR API KEY HERE”, “contact_ids”: [“contact_id1”, “contact_id2”], “contact_stage_id”: “stage_id” } headers = { ‘Cache-Control’: ‘no-cache’, ‘Content-Type’: ‘application/json’ } response = requests.request(“POST”, url, headers=headers, json=data) print(response.text)

{ “contacts”: [ { “id”: “5f34e4XXXXXXXXXXXXXXXXXX”, “first_name”: “Jon”, “last_name”: “Snow”, “name”: “Jon Snow”, “linkedin_url”: null, “title”: “Lord Commander”, “contact_stage_id”: “new_contact_stage_id”, “owner_id”: “5cc77dXXXXXXXXXXXXXXXXXX”, “person_id”: null, “email_needs_tickling”: false, “organization_name”: “Westeros”, “source”: “api”, “original_source”: “api”, “organization_id”: null, “headline”: null, “photo_url”: null, “present_raw_address”: null, “linkedin_uid”: null, “extrapolated_email_confidence”: 0, “salesforce_id”: null, “salesforce_lead_id”: null, “salesforce_contact_id”: null, “salesforce_account_id”: null, “salesforce_owner_id”: null, “created_at”: “2020-08-13T06:56:09.789Z”, “lead_request_id”: null, “test_predictive_score”: null, “emailer_campaign_ids”: [], “email_manually_changed”: true, “direct_dial_status”: null, “direct_dial_enrichment_failed_at”: null, “email_status”: “verified”, “account_id”: null, “last_activity_date”: null, “hubspot_vid”: null, “hubspot_company_id”: null, “sanitized_phone”: null, “merged_crm_ids”: [], “typed_custom_fields”: {}, “updated_at”: “2020-08-13T07:49:02.989Z”, “queued_for_crm_push”: false, “starred_by_user_ids”: [], “suggested_from_rule_engine_config_id”: null, “label_ids”: [], “has_pending_email_arcgate_request”: false, “has_email_arcgate_request”: false, “existence_level”: “full”, “email”: “[email protected]”, “contact_campaign_statuses”: [], “phone_numbers”: [], “account_phone_note”: null } ] }

POST https://api.apollo.io/v1/contacts/update_stages

Query Parameters

Parameter	Description
contact_ids	An array of contact ids. You can filter for a list of contact IDS with the contacts/search API.
contact_stage_id	The contact stage id to change into. You can GET a list of possible stage ids and its associated information from /contact_stages

curl -X POST -H “Content-Type: application/json” -H “Cache-Control: no-cache” -d ‘{ “api_key”: “YOUR API KEY HERE”, “contact_ids”: [“contact_id1”, “contact_id2”], “owner_id”: “owner_id” }’ “https://api.apollo.io/v1/contacts/update_owners” import requests url = “https://api.apollo.io/v1/contacts/update_owners” data = { “api_key”: “YOUR API KEY HERE”, “contact_ids”: [“contact_id1”, “contact_id2”], “owner_id”: “owner_id” } headers = { ‘Cache-Control’: ‘no-cache’, ‘Content-Type’: ‘application/json’ } response = requests.request(“POST”, url, headers=headers, json=data) print(response.text)

{ “contacts”: [ { “id”: “5f34e4XXXXXXXXXXXXXXXXXX”, “first_name”: “Jon”, “last_name”: “Snow”, “name”: “Jon Snow”, “linkedin_url”: null, “title”: “Lord Commander”, “contact_stage_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “owner_id”: “new_owner_id”, “person_id”: null, “email_needs_tickling”: false, “organization_name”: “Westeros”, “source”: “api”, “original_source”: “api”, “organization_id”: null, “headline”: null, “photo_url”: null, “present_raw_address”: null, “linkedin_uid”: null, “extrapolated_email_confidence”: 0, “salesforce_id”: null, “salesforce_lead_id”: null, “salesforce_contact_id”: null, “salesforce_account_id”: null, “salesforce_owner_id”: null, “created_at”: “2020-08-13T06:56:09.789Z”, “lead_request_id”: null, “test_predictive_score”: null, “emailer_campaign_ids”: [], “email_manually_changed”: true, “direct_dial_status”: null, “direct_dial_enrichment_failed_at”: null, “email_status”: “verified”, “account_id”: null, “last_activity_date”: null, “hubspot_vid”: null, “hubspot_company_id”: null, “sanitized_phone”: null, “merged_crm_ids”: [], “typed_custom_fields”: {}, “updated_at”: “2020-08-13T07:49:02.989Z”, “queued_for_crm_push”: false, “starred_by_user_ids”: [], “suggested_from_rule_engine_config_id”: null, “label_ids”: [], “has_pending_email_arcgate_request”: false, “has_email_arcgate_request”: false, “existence_level”: “full”, “email”: “[email protected]”, “contact_campaign_statuses”: [], “phone_numbers”: [], “account_phone_note”: null } ] }

POST https://api.apollo.io/v1/contacts/update_owners

Query Parameters

Parameter	Description
contact_ids	An array of contact ids. You can filter for a list of contact IDS with the contacts/search API.
owner_id	The owner id to change into. You can GET a list of possible users and its associated information from /users

An Account is a company your team has explicitly added to your database. It can be from prospected from Apollo, manually added by your team, or created by the API.

Create an Account

curl -X POST -H “Content-Type: application/json” -H “Cache-Control: no-cache” -d ‘{ “api_key”: “YOUR API KEY HERE”, “name”: “Google”, “domain”: “google.com”, “phone_number”: “1-866-246-6453”, “raw_address”: “1600 Amphitheatre Parkway” }’ “https://api.apollo.io/v1/accounts” import requests url = “https://api.apollo.io/v1/accounts” data = { “api_key”: “YOUR API KEY HERE”, “name”: “Google”, “domain”: “google.com”, “phone_number”: “1-866-246-6453”, “raw_address”: “1600 Amphitheatre Parkway” } headers = { ‘Cache-Control’: ‘no-cache’, ‘Content-Type’: ‘application/json’ } response = requests.request(“POST”, url, headers=headers, json=data) print(response.text)

{ “account”: { “id”: “5fe0XXXXXXXXXXXXXXXXXXXX”, “domain”: “google.com”, “name”: “Google”, “team_id”: “5fc6XXXXXXXXXXXXXXXXXXXX”, “typed_custom_fields”: {}, “organization_id”: null, “account_stage_id”: “5fc6XXXXXXXXXXXXXXXXXXXX”, “source”: “api”, “original_source”: “api”, “owner_id”: “5fc6XXXXXXXXXXXXXXXXXXXX”, “created_at”: “2020-12-21T15:33:02.709Z”, “phone”: null, “phone_status”: “no_status”, “test_predictive_score”: null, “hubspot_id”: null, “salesforce_id”: null, “crm_owner_id”: null, “parent_account_id”: null, “account_playbook_statuses”: [], “existence_level”: “full”, “label_ids”: [], “modality”: “account”, “persona_counts”: {} }, “team”: { “id”: “5fc6XXXXXXXXXXXXXXXXXXX”, “accounts_finder_empty”: false } }

POST https://api.apollo.io/v1/accounts

Parameter	Description
name	The account’s name
domain	The domain of the account you are adding
phone_number	The corporate phone for this account.
raw_address	The address string for this account, Apollo will intelligently infer the city, state, country, and time zone from your address

Update an Account

curl -X PUT -H “Content-Type: application/json” -H “Cache-Control: no-cache” -d ‘{ “api_key”: “YOUR API KEY HERE”, “name”: “new name “, }’ “https://api.apollo.io/v1/accounts/ACOUNT_ID” import requests url = “https://api.apollo.io/v1/accounts/ACOUNT_ID” data = { “api_key”: “YOUR API KEY HERE”, “name”: “new name “, } headers = { ‘Cache-Control’: ‘no-cache’, ‘Content-Type’: ‘application/json’ } response = requests.request(“PUT”, url, headers=headers, json=data) print(response.text)

{ “account”: { “id”: “5fe0XXXXXXXXXXXXXXXXXXXX”, “domain”: “google.com”, “name”: “new name”, “team_id”: “5fc6XXXXXXXXXXXXXXXXXXXX”, “typed_custom_fields”: {}, “organization_id”: null, “account_stage_id”: “5fc6XXXXXXXXXXXXXXXXXXXX”, “source”: “api”, “original_source”: “api”, “owner_id”: “5fc6XXXXXXXXXXXXXXXXXXXX”, “created_at”: “2020-12-21T15:55:01.956Z”, “phone”: null, “phone_status”: “no_status”, “test_predictive_score”: null, “hubspot_id”: null, “salesforce_id”: null, “crm_owner_id”: null, “parent_account_id”: null, “account_playbook_statuses”: [], “existence_level”: “full”, “label_ids”: [], “modality”: “account”, “persona_counts”: {} }, “labels”: [] }

PUT https://api.apollo.io/v1/accounts

Parameter	Description
id (Required)	Account ID
name	The account’s name
domain	The domain of the account you are updating
phone_number	The corporate phone for this account.

Search for Accounts

curl -X POST -H “Content-Type: application/json” -H “Cache-Control: no-cache” -d ‘{ “api_key”: “YOUR API KEY HERE”, “q_organization_name”: “Google”, “sort_by_field”: “account_last_activity_date”, “sort_ascending”: false }’ “https://api.apollo.io/v1/accounts/search” import requests url = “https://api.apollo.io/v1/accounts/search” data = { “api_key”: “YOUR API KEY HERE”, “q_organization_name”: “Google”, “sort_by_field”: “account_last_activity_date”, “sort_ascending”: False } headers = { ‘Cache-Control’: ‘no-cache’, ‘Content-Type’: ‘application/json’ } response = requests.request(“POST”, url, headers=headers, json=data) print(response.text)

{ “breadcrumbs”: [ { “label”: “Company Name”, “signal_field_name”: “q_organization_name”, “value”: “Google”, “display_name”: “Google” } ], “partial_results_only”: false, “disable_eu_prospecting”: false, “partial_results_limit”: 10000, “pagination”: { “page”: 1, “per_page”: 25, “total_entries”: 2, “total_pages”: 1 }, “accounts”: [ { “id”: “5c3d15XXXXXXXXXXXXXXXXXX”, “name”: “Google”, “website_url”: “http://www.google.com”, “blog_url”: null, “angellist_url”: “http://angel.co/google”, “linkedin_url”: “http://www.linkedin.com/company/google”, “twitter_url”: “http://twitter.com/google”, “facebook_url”: “https://www.facebook.com/Google”, “languages”: [ “English”, “German”, “Spanish”, “French”, “Italian”, “Portuguese”, “Chinese”, “Japanese”, “Russian”, “English” ], “alexa_ranking”: 1, “phone”: “(512) 225-6000”, “linkedin_uid”: “1441”, “publicly_traded_symbol”: “GOOG”, “publicly_traded_exchange”: “nasdaq”, “logo_url”: “https://zen-server.com/uploads/pictures/5f2d7fXXXXXXXXXXXXXXXXXX/picture”, “crunchbase_url”: “https://www.crunchbase.com/organization/google”, “primary_domain”: “google.com”, “starred_by_user_ids”: [], “persona_counts”: {}, “market_cap”: “835.5B”, “organization_raw_address”: “1600 Amphitheatre Parkway, Mountain View, CA”, “organization_city”: “Mountain View”, “organization_street_address”: “1600 Amphitheatre Parkway”, “organization_state”: “California”, “organization_country”: “United States”, “organization_postal_code”: “94043”, “suggest_location_enrichment”: false, “domain”: “google.com”, “team_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “typed_custom_fields”: {}, “organization_id”: “54fca10XXXXXXXXXXXXXXXXXX”, “account_stage_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “source”: “csv_import”, “original_source”: “csv_import”, “owner_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “created_at”: “2019-01-14T23:05:07.335Z”, “phone_status”: “no_status”, “test_predictive_score”: null, “hubspot_id”: null, “salesforce_id”: “0011UXXXXXXXXXXXXXX”, “salesforce_owner_id”: “0051UXXXXXXXXXXXXXX”, “parent_account_id”: null, “sanitized_phone”: “+15122256000”, “account_playbook_statuses”: [], “existence_level”: “full”, “label_ids”: [], “modality”: “account”, “salesforce_record_url”: “https://na85.salesforce.com/0011UXXXXXXXXXXXX”, “contact_emailer_campaign_ids”: [], “contact_campaign_status_tally”: {}, “num_contacts”: 12, “last_activity_date”: null } ], “num_fetch_result”: null }

POST https://api.apollo.io/v1/accounts/search

Parameter	Description
q_organization_name	The account’s name
account_stage_ids	An array of stage ids the account must belong to. Refer to /account_stages to get a list of possible stage ids.
sort_by_field	Possible values: “account_last_activity_date” or “account_created_at”
sort_ascending	Possible values: true or false
page	which page to return. Defaults to 1
per_page	how many accounts to return per page. Max = 200

Get a List of Account Stages

curl -X GET -H “Content-Type: application/json” -H “Cache-Control: no-cache” “https://api.apollo.io/v1/account_stages?api_key=YOUR_API_KEY_HERE” import requests url = “https://api.apollo.io/v1/account_stages” querystring = { “api_key”: “YOUR API KEY HERE” } headers = { ‘Cache-Control’: ‘no-cache’, ‘Content-Type’: ‘application/json’ } response = requests.request(“GET”, url, headers=headers, params=querystring) print(response.text)

{ “account_stages”: [ { “id”: “5c1004XXXXXXXXXXXXXXXXXX”, “team_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “display_name”: “Cold”, “name”: “Cold”, “display_order”: 0, “default_exclude_for_leadgen”: false, “category”: “in_progress” }, { “id”: “5c1004XXXXXXXXXXXXXXXXXX”, “team_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “display_name”: “Current Client”, “name”: “Current Client”, “display_order”: 1, “default_exclude_for_leadgen”: true, “category”: “succeeded” }, { “id”: “5c1004a04XXXXXXXXXXXXXX”, “team_id”: “5c1004aXXXXXXXXXXXXXXXX”, “display_name”: “Active Opportunity”, “name”: “Active Opportunity”, “display_order”: 2, “default_exclude_for_leadgen”: true, “category”: “succeeded” }, { “id”: “5c1004XXXXXXXXXXXXXXXXXX”, “team_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “display_name”: “Dead Opportunity”, “name”: “Dead Opportunity”, “display_order”: 3, “default_exclude_for_leadgen”: false, “category”: “failed” }, { “id”: “5c1004XXXXXXXXXXXXXXXXXX”, “team_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “display_name”: “Do Not Prospect”, “name”: “Do Not Prospect”, “display_order”: 4, “default_exclude_for_leadgen”: true, “category”: “failed” } ] }

GET https://api.apollo.io/v1/account_stages

Update Account Stage

curl -X POST -H “Content-Type: application/json” -H “Cache-Control: no-cache” -d ‘{ “api_key”: “YOUR API KEY HERE”, “account_ids”: [“account_id1”, “account_id2”], “account_stage_id”: “stage_id” }’ “https://api.apollo.io/v1/accounts/bulk_update” import requests url = “https://api.apollo.io/v1/accounts/bulk_update” data = { “api_key”: “YOUR API KEY HERE”, “account_ids”: [“account_id1”, “account_id2”], “account_stage_id”: “stage_id” } headers = { ‘Cache-Control’: ‘no-cache’, ‘Content-Type’: ‘application/json’ } response = requests.request(“POST”, url, headers=headers, json=data) print(response.text)

{ “accounts”: [ { “id”: “5c3d15XXXXXXXXXXXXXXXXXX”, “account_stage_id”: “new_account_stage_id” } ] }

POST https://api.apollo.io/v1/accounts/bulk_update

Query Parameters

Parameter	Description
account_ids	An array of account ids. You can filter for a list of account IDS with the accounts/search API.
account_stage_id	The account stage id to change into. You can GET a list of possible stage ids and its associated information from /account_stages

Update Account Ownership

curl -X POST -H “Content-Type: application/json” -H “Cache-Control: no-cache” -d ‘{ “api_key”: “YOUR API KEY HERE”, “account_ids”: [“account_id1”, “account_id2”], “owner_id”: “owner_id” }’ “https://api.apollo.io/v1/accounts/update_owners” import requests url = “https://api.apollo.io/v1/accounts/update_owners” data = { “api_key”: “YOUR API KEY HERE”, “account_ids”: [“account_id1”, “account_id2”], “owner_id”: “owner_id” } headers = { ‘Cache-Control’: ‘no-cache’, ‘Content-Type’: ‘application/json’ } response = requests.request(“POST”, url, headers=headers, json=data) print(response.text)

{ “accounts”: [ { “id”: “5c3d15XXXXXXXXXXXXXXXXXX”, “owner_id”: “new_owner_id” } ] }

POST https://api.apollo.io/v1/accounts/update_owners

Query Parameters

Parameter	Description
account_ids	An array of account ids. You can filter for a list of account IDS with the accounts/search API.
owner_id	The owner id to change into. You can GET a list of possible users and its associated information from /users

Use the Sequences API to interact with sequences, add contacts to sequence, and more!

Search for sequences

curl -X POST -H “Content-Type: application/json” -H “Cache-Control: no-cache” -d ‘{ “api_key”: “YOUR API KEY HERE”, “q_name”: “Sequence Name” }’ “https://api.apollo.io/v1/emailer_campaigns/search” import requests url = “https://api.apollo.io/v1/emailer_campaigns/search” data = { “api_key”: “YOUR API KEY HERE”, “q_name”: “Sequence Name” } headers = { ‘Cache-Control’: ‘no-cache’, ‘Content-Type’: ‘application/json’ } response = requests.request(“POST”, url, headers=headers, json=data) print(response.text)

{ “pagination”: { “page”: 1, “per_page”: 25, “total_entries”: 1, “total_pages”: 1 }, “breadcrumbs”: [ { “label”: “Name”, “signal_field_name”: “q_name”, “value”: “Manual Message Sequence”, “display_name”: “Manual Message Sequence” } ], “emailer_campaigns”: [ { “id”: “5c8751XXXXXXXXXXXXXXXX”, “name”: “Manual Message Sequence”, “archived”: false, “created_at”: “2019-03-12T06:27:23.539Z”, “emailer_schedule_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “max_emails_per_day”: null, “user_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “same_account_reply_policy_cd”: null, “excluded_account_stage_ids”: [ “5c1004XXXXXXXXXXXXXXXXXX”, “5c1004XXXXXXXXXXXXXXXXXX”, “5c1004XXXXXXXXXXXXXXXXXX”, “5c1004XXXXXXXXXXXXXXXXXX” ], “excluded_contact_stage_ids”: [ “5c1004XXXXXXXXXXXXXXXXXX”, “5c1004XXXXXXXXXXXXXXXXXX”, “5c1004XXXXXXXXXXXXXXXXXX”, “5c1004XXXXXXXXXXXXXXXXXX” ], “contact_email_event_to_stage_mapping”: {}, “label_ids”: [], “create_task_if_email_open”: false, “email_open_trigger_task_threshold”: 3, “mark_finished_if_click”: false, “active”: false, “days_to_wait_before_mark_as_response”: 5, “starred_by_user_ids”: [], “mark_finished_if_reply”: true, “mark_finished_if_interested”: true, “mark_paused_if_ooo”: true, “sequence_by_exact_daytime”: null, “permissions”: “team_can_view”, “last_used_at”: “2020-04-07T00:34:36.244+00:00”, “sequence_ruleset_id”: “5c1004a041f5ac0995d5f61f”, “folder_id”: null, “same_account_reply_delay_days”: 30, “num_steps”: 1, “unique_scheduled”: 0, “unique_delivered”: 1, “unique_bounced”: 0, “unique_opened”: 1, “unique_replied”: 0, “unique_demoed”: 0, “unique_clicked”: 0, “unique_unsubscribed”: 0, “bounce_rate”: 0, “open_rate”: 1, “click_rate”: 0, “reply_rate”: 0, “spam_blocked_rate”: 0, “opt_out_rate”: 0, “demo_rate”: 0, “loaded_stats”: true, “cc_emails”: “”, “bcc_emails”: “” } ], “num_fetch_result”: null }

POST https://api.apollo.io/v1/emailer_campaigns/search

Parameter	Description	Example
q_name	Name	“Name of Sequence”

curl -X POST -H “Content-Type: application/json” -H “Cache-Control: no-cache” -d ‘{ “api_key”: “YOUR API KEY HERE”, “async”: false, “contact_ids”: [“contact id 1”, “contact id 2”], “emailer_campaign_id”: REPLACE_WITH_SEQUENCE_ID, “send_email_from_email_account_id”: “email_account_id”, “sequence_active_in_other_campaigns”: false, “sequence_no_email”: false, “sequence_finished_in_other_campaigns”: false, }’ “https://api.apollo.io/v1/emailer_campaigns/REPLACE_WITH_SEQUENCE_ID/add_contact_ids” import requests url = “https://api.apollo.io/v1/emailer_campaigns/REPLACE_WITH_SEQUENCE_ID/add_contact_ids” data = { “api_key”: “YOUR API KEY HERE”, “async”: False, “contact_ids”: [“contact id 1”, “contact id 2”], “emailer_campaign_id”: REPLACE_WITH_SEQUENCE_ID, “send_email_from_email_account_id”: “email_account_id”, “sequence_active_in_other_campaigns”: False, “sequence_no_email”: False, “sequence_finished_in_other_campaigns”: False, } headers = { ‘Cache-Control’: ‘no-cache’, ‘Content-Type’: ‘application/json’ } response = requests.request(“POST”, url, headers=headers, json=data) print(response.text)

{ “contacts”: [ { “id”: “5c1004XXXXXXXXXXXXXXXXXX”, “first_name”: “Ray”, “last_name”: “Li”, “name”: “Ray Li”, “linkedin_url”: null, “title”: “CTO”, “contact_stage_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “owner_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “person_id”: null, “email_needs_tickling”: false, “organization_name”: “Apollo”, “organization_id”: null, “headline”: null, “photo_url”: null, “present_raw_address”: null, “linkedin_uid”: null, “extrapolated_email_confidence”: 0.0, “salesforce_id”: “0036g000XXXXXXX”, “salesforce_lead_id”: null, “salesforce_contact_id”: “0036g0000XXXXXXXXX”, “salesforce_account_id”: “0016g0000XXXXXXXXX”, “salesforce_owner_id”: “0056g000000XXXXXXXXX”, “created_at”: “2020-07-27T01:23:36.898Z”, “lead_request_id”: null, “test_predictive_score”: null, “emailer_campaign_ids”: [ “5c1004XXXXXXXXXXXXXXXXXX” ], “email_manually_changed”: false, “direct_dial_status”: null, “direct_dial_enrichment_failed_at”: null, “email_status”: “verified”, “account_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “last_activity_date”: null, “hubspot_vid”: null, “hubspot_company_id”: null, “sanitized_phone”: “+165XXXXXX”, “merged_crm_ids”: [], “typed_custom_fields”: {}, “updated_at”: “2020-07-27T01:23:36.898Z”, “queued_for_crm_push”: false, “starred_by_user_ids”: [], “suggested_from_rule_engine_config_id”: null, “label_ids”: [], “has_pending_email_arcgate_request”: false, “has_email_arcgate_request”: false, “existence_level”: “full”, “email”: “[email protected]”, “salesforce_record_url”: “https://na174.salesforce.com/0036g00000XXXXXXX”, “contact_campaign_statuses”: [ { “id”: “5c1004XXXXXXXXXXXXXXXXXX”, “emailer_campaign_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “send_email_from_user_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “inactive_reason”: “Sequence inactive”, “status”: “paused”, “added_at”: “2020-08-26T17:53:02.533+00:00”, “added_by_user_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “finished_at”: null, “paused_at”: null, “auto_unpause_at”: null, “send_email_from_email_address”: “[email protected]”, “send_email_from_email_account_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “manually_set_unpause”: null, “failure_reason”: null, “current_step_id”: null, “current_step_position”: null } ], “phone_numbers”: [ ], “account_phone_note”: null } ], “emailer_campaign”: { “id”: “5c1004XXXXXXXXXXXXXXXXXX”, “name”: “Test Sequence”, “archived”: false, “created_at”: “2020-08-26T09:21:01.510Z”, “emailer_schedule_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “max_emails_per_day”: null, “user_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “same_account_reply_policy_cd”: null, “excluded_account_stage_ids”: [ “5c1004XXXXXXXXXXXXXXXXXX”, “5c1004XXXXXXXXXXXXXXXXXX”, “5c1004XXXXXXXXXXXXXXXXXX”, “5c1004XXXXXXXXXXXXXXXXXX” ], “excluded_contact_stage_ids”: [ “5c1004XXXXXXXXXXXXXXXXXX”, “5c1004XXXXXXXXXXXXXXXXXX”, “5c1004XXXXXXXXXXXXXXXXXX”, “5c1004XXXXXXXXXXXXXXXXXX” ], “contact_email_event_to_stage_mapping”: {}, “label_ids”: [], “create_task_if_email_open”: false, “email_open_trigger_task_threshold”: 3, “mark_finished_if_click”: false, “active”: false, “days_to_wait_before_mark_as_response”: 5, “starred_by_user_ids”: [], “mark_finished_if_reply”: true, “mark_finished_if_interested”: true, “mark_paused_if_ooo”: true, “sequence_by_exact_daytime”: null, “permissions”: “”, “last_used_at”: “2020-08-26T17:53:02.672+00:00”, “sequence_ruleset_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “folder_id”: null, “same_account_reply_delay_days”: 30, “unique_scheduled”: “loading”, “unique_delivered”: 0, “unique_bounced”: 0, “unique_opened”: 0, “unique_replied”: 0, “unique_demoed”: 0, “unique_clicked”: 0, “unique_unsubscribed”: 0, “bounce_rate”: 0.0, “open_rate”: 0.0, “click_rate”: 0.0, “reply_rate”: 0.0, “spam_blocked_rate”: 0.0, “opt_out_rate”: 0.0, “demo_rate”: 0.0, “loaded_stats”: true, “contact_statuses”: { “active”: “loading”, “failed”: “loading”, “paused”: “loading”, “finished”: “loading”, “bounced”: “loading”, “not_sent”: “loading” }, “num_contacts”: 1, “cc_emails”: “”, “bcc_emails”: “” }, “emailer_steps”: [], “emailer_touches”: [], “team”: { “id”: “5c1004XXXXXXXXXXXXXXXXXX”, “sequences_finder_empty”: false } }

POST https://api.apollo.io/v1/emailer_campaigns/REPLACE_WITH_SEQUENCE_ID/add_contact_ids

Parameter	Description	Example
id (required, embedded in URL)	ID of the sequence	“583f2f7ed9ced98ab5bfXXXX”
contact_ids (required)	An array of contact Ids	[“583f2f7ed9ced98ab5bfXXXX”, “583f2f7ed9ced98ab5bfXXXX”]
emailer_campaign_id (required)	The ID of sequence to deploy to	“583f2f7ed9ced98ab5bfXXXX”
send_email_from_email_account_id (required)	ID of the email account to send email from, use the email_account/search api to figure out the list IDs	“583f2f7ed9ced98ab5bfXXXX”
sequence_no_email	Whether to still sequence the contact if he/she does not have an email address	true or false (default false)
sequence_active_in_other_campaigns	Whether to still sequence the contact if he/she is active or paused in another sequence	true or false (default false)
sequence_finished_in_other_campaigns	Whether to still sequence the contact if he/she already finished another sequence	true or false (default false)
async	Whether process should be executed synchronously or asynchronously	true or false (default false)

curl -X POST -H “Content-Type: application/json” -H “Cache-Control: no-cache” -d ‘{ “api_key”: “YOUR API KEY HERE”, “emailer_campaign_ids”: [“contact id 1”, “contact id 2”], “contact_ids”: [“contact id 1”, “contact id 2”], “mode”: “remove”, “async”: “false” }’ “https://api.apollo.io/v1/emailer_campaigns/remove_or_stop_contact_ids” import requests url = “https://api.apollo.io/v1/emailer_campaigns/remove_or_stop_contact_ids” data = { “api_key”: “YOUR API KEY HERE”, “emailer_campaign_ids”: [“contact id 1”, “contact id 2”], “contact_ids”: [“contact id 1”, “contact id 2”], “mode”: “remove”, “async”: False } headers = { ‘Cache-Control’: ‘no-cache’, ‘Content-Type’: ‘application/json’ } response = requests.request(“POST”, url, headers=headers, json=data) print(response.text)

{ “contacts”: [ { “id”: “5f0d9de3XXXXXXXXXXXXXXXXXX”, “first_name”: “Jon”, “last_name”: “Snow”, “name”: “Jon Snow”, “linkedin_url”: null, “title”: null, “contact_stage_id”: “5f0d9d5aXXXXXXXXXXXXXXXXXX”, “owner_id”: “5f0d9d5XXXXXXXXXXXXXXXXXX”, “person_id”: null, “email_needs_tickling”: false, “organization_name”: “Winter”, “organization_id”: null, “headline”: null, “photo_url”: null, “present_raw_address”: null, “linkedin_uid”: null, “extrapolated_email_confidence”: 0.0, “salesforce_id”: null, “salesforce_lead_id”: null, “salesforce_contact_id”: null, “salesforce_account_id”: null, “salesforce_owner_id”: null, “created_at”: “2020-07-14T11:58:27.395Z”, “lead_request_id”: null, “test_predictive_score”: null, “emailer_campaign_ids”: [], “email_manually_changed”: false, “direct_dial_status”: null, “direct_dial_enrichment_failed_at”: null, “email_status”: “verified”, “account_id”: null, “last_activity_date”: null, “hubspot_vid”: null, “hubspot_company_id”: null, “sanitized_phone”: null, “merged_crm_ids”: [], “typed_custom_fields”: {}, “updated_at”: “2020-07-14T11:58:27.395Z”, “queued_for_crm_push”: false, “starred_by_user_ids”: [], “suggested_from_rule_engine_config_id”: null, “label_ids”: [], “has_pending_email_arcgate_request”: false, “has_email_arcgate_request”: false, “existence_level”: “full”, “email”: “[email protected]”, “contact_campaign_statuses”: [], “phone_numbers”: [], “account_phone_note”: null } ], “emailer_campaigns”: [ { “id”: “5f46297XXXXXXXXXXXXXXXXXX” } ], “num_contacts”: 0, “contact_statuses”: { “active”: “loading”, “failed”: “loading”, “paused”: “loading”, “finished”: “loading”, “bounced”: “loading”, “not_sent”: “loading” }, “emailer_steps”: [] }

POST https://api.apollo.io/v1/emailer_campaigns/remove_or_stop_contact_ids

Parameter	Description	Example
emailer_campaign_ids (required)	A list of ids to remove all contacts from	[“583f2f7ed9ced98ab5bfXXXX”, “583f2f7ed9ced98ab5bfXXXX”]
contact_ids (required)	An array of contact Ids to remove from the sequences	[“583f2f7ed9ced98ab5bfXXXX”, “583f2f7ed9ced98ab5bfXXXX”]
mode (required)	Whether to remove the contacts from the sequence, or mark them as finished or stop them	mark_as_finished OR remove OR stop

A task is an action to be performed on a contact, The Task can be assigned to any member of your team and also given the appropriate priority

Creating a task

curl -X POST -H “Content-Type: application/json” -H “Cache-Control: no-cache” -d ‘{ “priority”: “medium”, “user_id”: “5c10XXXXXXXXXXXXXXXXXXXX”, “due_at”: “2020-12-21T16:16:48.311Z”, “type”: “call”, “contact_ids”: [ “5cd9XXXXXXXXXXXXXXXXXXXX”, “5cd9XXXXXXXXXXXXXXXXXXXX” ], “note”: “Note to be attached to the task”, “status”: “scheduled” }’ “https://api.apollo.io/v1/tasks/bulk_create” import requests url = “https://api.apollo.io/v1/tasks/bulk_create” data = { “api_key”: “YOUR API KEY HERE”, “priority”: “medium”, “user_id”: “5c10XXXXXXXXXXXXXXXXXXXX”, “due_at”: “2020-12-21T16:16:48.311Z”, “type”: “call”, “contact_ids”: [ “5cd9XXXXXXXXXXXXXXXXXXXX”, “5cd9XXXXXXXXXXXXXXXXXXXX” ], “note”: “Note to be attached to the task”, “status”: “scheduled” } headers = { ‘Cache-Control’: ‘no-cache’, ‘Content-Type’: ‘application/json’ } response = requests.request(“POST”, url, headers=headers, json=data) print(response.text)

POST https://api.apollo.io/v1/tasks/bulk_create

Parameter	Description	Example
priority (required)	Priority of the task	“high”/”medium”/”low”
user_id	The ID of the user the task is to be assigned to . You can GET a list of possible users from Misc/Users	“583f2f7ed9ced98ab5bfXXXX”
due_at	the due date and time for the task	2020-12-21T16:16:48.311Z
type	The type of the task there are 3 valid task types call, outreach_manual_email ,action_item	call, outreach_manual_email ,action_item
contact_ids (required)	An array of contact Ids	[“583f2f7ed9ced98ab5bfXXXX”, “583f2f7ed9ced98ab5bfXXXX”]
note	note to be attached to the task	“Example note”
status	the status of the task	“scheduled”

Getting a list of tasks

curl -X GET -H “Content-Type: application/json” -H “Cache-Control: no-cache” -d ‘{ “api_key”: “YOUR API KEY HERE”, “sort_by_field”: “task_created_at”, “per_page”: 200, “open_factor_names”: [ “task_types” ] }’ “https://api.apollo.io/v1/tasks/search” import requests url = “https://api.apollo.io/v1/tasks/search” querystring = { “api_key”: “YOUR API KEY HERE”, “sort_by_field”: “task_created_at”, “per_page”: 200, “open_factor_names”: [ “task_types” ] } headers = { ‘Cache-Control’: ‘no-cache’, ‘Content-Type’: ‘application/json’ } response = requests.request(“GET”, url, headers=headers, params=querystring) print(response.text)

{ “tasks”: [ { “emailer_campaign_id”: null, “id”: “5ff3XXXXXXXXXXXXXXXXXXXX”, “user_id”: “5fc6XXXXXXXXXXXXXXXXXXXX”, “created_at”: “2021-01-04T15:48:10.467Z”, “completed_at”: null, “note”: null, “skipped_at”: null, “due_at”: “2021-01-04T15:46:48.361+00:00”, “type”: “action_item”, “priority”: “medium”, “status”: “scheduled”, “answered”: null, “contact_id”: “5fd1XXXXXXXXXXXXXXXXXXXX”, “person_id”: null, “account_id”: “5fd1XXXXXXXXXXXXXXXXXXXX”, “organization_id”: null, “persona_ids”: [], “subject”: null, “created_from”: “zp_ui”, “salesforce_type”: null, “playbook_step_ids”: [], “playbook_id”: null, “needs_playbook_autoprospecting”: null, “starred_by_user_ids”: [], “salesforce_id”: null, “hubspot_id”: null, “account”: { “id”: “5fd1XXXXXXXXXXXXXXXXXXXX”, “domain”: “.com”, “name”: “google”, “team_id”: “5fc6XXXXXXXXXXXXXXXXXXXX”, “typed_custom_fields”: {}, “organization_id”: null, “account_stage_id”: null, “source”: “salesforce”, “original_source”: “salesforce”, “owner_id”: “5fc6XXXXXXXXXXXXXXXXXXXX”, “created_at”: “2020-12-09T21:41:51.657Z”, “phone”: “(800) 424-9299”, “phone_status”: “no_status”, “test_predictive_score”: null, “hubspot_id”: null, “salesforce_id”: “0011U0XXXXXXXXXXXX”, “crm_owner_id”: “0051U0XXXXXXXXXXXX”, “parent_account_id”: null, “sanitized_phone”: “+180xxxxxxxx”, “account_playbook_statuses”: [], “existence_level”: “full”, “label_ids”: [], “modality”: “account”, “salesforce_record_url”: “https://na85.salesforce.com/0011U0XXXXXXXXXXXX”, “persona_counts”: {} }, “contact”: { “id”: “5fd1XXXXXXXXXXXXXXXXXXXX”, “first_name”: “John”, “last_name”: “Doe”, “name”: “John Doe”, “linkedin_url”: null, “title”: “Senior QA Specialist”, “contact_stage_id”: “5fc6XXXXXXXXXXXXXXXXXXXX”, “owner_id”: “5fc6XXXXXXXXXXXXXXXXXXXX”, “person_id”: null, “email_needs_tickling”: false, “organization_name”: null, “source”: “salesforce_contact”, “original_source”: “salesforce_contact”, “organization_id”: null, “headline”: null, “photo_url”: null, “present_raw_address”: “Washington, District of Columbia, United States”, “linkedin_uid”: null, “extrapolated_email_confidence”: 0.0, “salesforce_id”: “0031U0XXXXXXXXXXXX”, “salesforce_lead_id”: null, “salesforce_contact_id”: “0031U0XXXXXXXXXXXX”, “salesforce_account_id”: “0011U0XXXXXXXXXXXX”, “crm_owner_id”: “0051U0XXXXXXXXXXXX”, “created_at”: “2020-12-09T21:41:57.503Z”, “test_predictive_score”: null, “emailer_campaign_ids”: [], “email_manually_changed”: false, “direct_dial_status”: null, “direct_dial_enrichment_failed_at”: null, “email_status”: “verified”, “account_id”: “5fd1XXXXXXXXXXXXXXXXXXXX”, “last_activity_date”: null, “hubspot_vid”: null, “hubspot_company_id”: null, “sanitized_phone”: “+180xxxxxxxx”, “merged_crm_ids”: [], “typed_custom_fields”: {}, “updated_at”: “2020-12-28T10:51:37.432Z”, “queued_for_crm_push”: false, “suggested_from_rule_engine_config_id”: null, “email_unsubscribed”: false, “label_ids”: [], “has_pending_email_arcgate_request”: false, “has_email_arcgate_request”: false, “existence_level”: “full”, “email”: “[email protected]”, “salesforce_record_url”: “https://na85.salesforce.com/0031U0XXXXXXXXXXXX”, “outreach_id”: “1X7”, “outreach_url”: “https://app2a.outreach.io/prospects/XXX/overview”, “salesloft_id”: “6XX1XX5X”, “salesloft_url”: “https://app.salesloft.com/app/people/6XXXXXXX”, “phone_numbers”: [ { “raw_number”: “(X00) 4X4-XXXX”, “sanitized_number”: “+280XXXXXXXX”, “type”: “other”, “position”: 0, “status”: “no_status” } ], “account_phone_note”: null } } { “emailer_campaign_id”: null, “id”: “5ff3XXXXXXXXXXXXXXXXXXXX”, “user_id”: “5fc6XXXXXXXXXXXXXXXXXXXX”, “created_at”: “2021-01-04T15:36:09.033Z”, “completed_at”: null, “note”: “Call Contact”, “skipped_at”: null, “due_at”: “2021-01-04T15:35:58.054+00:00”, “type”: “call”, “priority”: “medium”, “status”: “scheduled”, “answered”: null, “contact_id”: “5fd1XXXXXXXXXXXXXXXXXXXX”, “person_id”: null, “account_id”: “5fd1XXXXXXXXXXXXXXXXXXXX”, “organization_id”: null, “persona_ids”: [], “subject”: null, “created_from”: “zp_ui”, “salesforce_type”: null, “playbook_step_ids”: [], “playbook_id”: null, “needs_playbook_autoprospecting”: null, “starred_by_user_ids”: [], “salesforce_id”: null, “hubspot_id”: null, “account”: { “id”: “5fd1XXXXXXXXXXXXXXXXXXXX”, “domain”: “apple.com”, “name”: “Apple”, “team_id”: “5fcXXXXXXXXXXXXXXXXXXXX”, “typed_custom_fields”: {}, “organization_id”: null, “account_stage_id”: null, “source”: “salesforce”, “original_source”: “salesforce”, “owner_id”: “5fc6XXXXXXXXXXXXXXXXXXXX”, “created_at”: “2020-12-09T21:41:51.657Z”, “phone”: “(X00) 4X4-XXXX”, “phone_status”: “no_status”, “test_predictive_score”: null, “hubspot_id”: null, “salesforce_id”: “0011U0XXXXXXXXXXXX”, “crm_owner_id”: “0051U0XXXXXXXXXXXX”, “parent_account_id”: null, “sanitized_phone”: “+3X0042XXXXX”, “account_playbook_statuses”: [], “existence_level”: “full”, “label_ids”: [], “modality”: “account”, “salesforce_record_url”: “https://na85.salesforce.com/0011U0XXXXXXXXXXXX”, “persona_counts”: {} }, “contact”: { “id”: “5fd1XXXXXXXXXXXXXXXXXXXX”, “first_name”: “Jane”, “last_name”: “doe”, “name”: “Jane Doe”, “linkedin_url”: null, “title”: “Senior Engineer”, “contact_stage_id”: “5fc6XXXXXXXXXXXXXXXXXXXX”, “owner_id”: “5fc6XXXXXXXXXXXXXXXXXXXX”, “person_id”: null, “email_needs_tickling”: false, “organization_name”: null, “source”: “salesforce_contact”, “original_source”: “salesforce_contact”, “organization_id”: null, “headline”: null, “photo_url”: null, “present_raw_address”: “Washington, District of Columbia, United States”, “linkedin_uid”: null, “extrapolated_email_confidence”: 0.0, “salesforce_id”: “003XXXXXXXXXXXXXXX”, “salesforce_lead_id”: null, “salesforce_contact_id”: “0031XXXXXXXxXXXXX”, “salesforce_account_id”: “0011U00XXXXXXxXXX”, “crm_owner_id”: “0051U0XXXXXXXXXXXX”, “created_at”: “2020-12-09T21:41:57.503Z”, “test_predictive_score”: null, “emailer_campaign_ids”: [], “email_manually_changed”: false, “direct_dial_status”: null, “direct_dial_enrichment_failed_at”: null, “email_status”: “verified”, “account_id”: “5fd1XXXXXXXXXXXXXXXXXXXX”, “last_activity_date”: null, “hubspot_vid”: null, “hubspot_company_id”: null, “sanitized_phone”: “+18XXXXXXXXX”, “merged_crm_ids”: [], “typed_custom_fields”: {}, “updated_at”: “2020-12-28T10:51:37.432Z”, “queued_for_crm_push”: false, “suggested_from_rule_engine_config_id”: null, “email_unsubscribed”: false, “label_ids”: [], “has_pending_email_arcgate_request”: false, “has_email_arcgate_request”: false, “existence_level”: “full”, “email”: “[email protected]”, “salesforce_record_url”: “https://naXX.salesforce.com/0031U00XXXXXXXXXXXX”, “outreach_id”: “4XX”, “outreach_url”: “https://app2a.outreach.io/prospects/4XX/overview”, “salesloft_id”: “62619350”, “salesloft_url”: “https://app.salesloft.com/app/people/62XXXXXX”, “phone_numbers”: [ { “raw_number”: “(8XX) 4X4-XXXX”, “sanitized_number”: “+1X004XXXXXX”, “type”: “other”, “position”: 0, “status”: “no_status” } ], “account_phone_note”: null } } ], “breadcrumbs”: [], “pagination”: { “page”: 1, “per_page”: 2, “total_entries”: 20, “total_pages”: 7 }, “faceting”: { “playbook_step_facets”: [], “person_function_facets”: [], “person_seniority_facets”: [], “normalized_person_title_facets”: [], “organization_ids_facets”: [], “organization_ids_in_query_facets”: [], “person_persona_facets”: [], “organization_keywords_facets”: [], “linkedin_industry_facets”: [], “linkedin_specialty_facets”: [], “angellist_market_facets”: [], “linkedin_company_size_facets”: [], “num_employees_facets”: [], “currently_using_any_of_technology_uids_facets”: [], “currently_using_all_of_technology_uids_facets”: [], “currently_not_using_any_of_technology_uids_facets”: [], “added_technology_uids_facets”: [], “dropped_technology_uids_facets”: [], “latest_funding_stage_facets”: [], “person_city_facets”: [], “person_state_facets”: [], “person_country_facets”: [], “organization_hq_city_facets”: [], “organization_hq_state_facets”: [], “organization_hq_country_facets”: [], “task_types”: [ { “value”: “contact_call”, “display_name”: “Call Contact”, “count”: 14 }, { “value”: “outreach_manual_email”, “display_name”: “Email Contact”, “count”: 5 }, { “value”: “contact_action_item”, “display_name”: “Contact Action Item”, “count”: 1 } ], “total_facets”: [ { “value”: “pipeline_total”, “display_name”: “Total”, “count”: 20 } ] }, “pipeline_total”: 20, “num_fetch_result”: null }

GET https://api.apollo.io/v1/tasks/search

Parameter	Description	Example
open_factor_names (required)	This is a required field and must be passed in with the request	[“task_types”]
per_page	how many tasks to return per page. Max = 200	100

Get a List of Users

curl -X GET -H “Content-Type: application/json” -H “Cache-Control: no-cache” “https://api.apollo.io/v1/users/search?api_key=YOUR_API_KEY_HERE” import requests url = “https://api.apollo.io/v1/users/search” querystring = { “api_key”: “YOUR API KEY HERE” } headers = { ‘Cache-Control’: ‘no-cache’, ‘Content-Type’: ‘application/json’ } response = requests.request(“GET”, url, headers=headers, params=querystring) print(response.text)

{ “pagination”: { “page”: null, “per_page”: 25, “total_entries”: 2, “total_pages”: 1 }, “users”: [ { “id”: “5cc77dXXXXXXXXXXXXXXXXXX”, “team_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “first_name”: “Test”, “last_name”: “User”, “title”: null, “email”: “[email protected]”, “created_at”: “2019-04-29T22:39:36.645Z”, “credit_limit”: 50, “direct_dial_credit_limit”: 0, “salesforce_account”: null, “deleted”: false, “should_include_unsubscribe_link”: false, “opt_out_html_template”: “If you don’t want to hear from me again, please <%let me know%>.”, “name”: “Test User”, “enable_click_tracking”: false, “password_needs_reset”: false, “salesforce_id”: null, “default_cockpit_layout”: null, “default_finder_view_ids”: {}, “default_account_overview_layout_id”: null, “default_organization_overview_layout_id”: null, “default_contact_overview_layout_id”: null, “bridge_calls”: false, “bridge_phone_number”: null, “bridge_incoming_calls”: false, “bridge_incoming_phone_number”: null, “current_email_verified”: true, “record_calls”: true, “salesforce_instance_url”: null, “permission_set_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “assistant_setting”: { “_id”: “5cc77dXXXXXXXXXXXXXXXXXX”, “deal_size_metric”: “amount”, “inactive_account_stage_ids”: [], “inactive_contact_stage_ids”: [], “insight_deal_size_signals”: {}, “insight_sale_cycle_signals”: {}, “insight_win_rate_signals”: {}, “job_posting_locations”: [], “job_posting_titles”: [], “latest_funding_days”: 90, “latest_news_days”: 30, “max_num_active_accounts”: 100, “max_people_in_sequence_per_account”: 5, “num_inactive_days_to_re_engage”: 180, “persona_ids”: [ “5c1004XXXXXXXXXXXXXXXXXX”, “5c1004XXXXXXXXXXXXXXXXXX” ], “success_case_account_stage_ids”: [], “technology_uids”: [], “territory_company_size_ranges”: [], “territory_location_override”: false, “territory_locations”: [ “United States” ], “territory_person_locations”: [ “United States” ], “id”: “5cc77dXXXXXXXXXXXXXXXXXX”, “key”: “5cc77XXXXXXXXXXXXXXXXXX” }, “typed_custom_fields”: {}, “default_use_local_numbers”: false, “disable_email_linking”: null, “sync_salesforce_id”: null, “sync_crm_id”: null, “zp_contact_id”: “59f9e0XXXXXXXXXXXXXXXXXX”, “chrome_extension_downloaded”: false, “user_roles”: [], “email_oauth_signin_only”: false, “notification_last_created_at”: “2020-04-07T00:40:12.399+00:00”, “crm_requested_to_integrate”: null, “has_invited_user”: false, “notification_last_read_at”: null, “daily_data_request_email”: false, “data_request_emails”: true, “daily_task_email”: true, “free_data_credits_email”: true, “dismiss_new_team_suggestion”: null, “request_email_change_to”: null, “self_identified_persona”: “Product”, “added_contact_to_sequence”: false, “has_approved_emailer_campaign”: false, “main_emailer_campaign_id”: null, “current_onboarding_step”: “create_account”, “onboarding_use_cases”: { “bulk_status”: “started”, “current_use_case”: “bulk”, “first_user_case”: “bulk”, “searched_people”: true, “download_leads”: true }, “skip_use_case_selection”: false, “subteam_ids”: [ “5cc77XXXXXXXXXXXXXXXXXX” ], “prospect_territory_ids”: [], “linked_salesforce”: null, “linked_hubspot”: false, “linked_salesloft”: false, “default_chrome_extension_log_email_send_to_salesforce”: true, “chrome_extension_auto_match_salesforce_opportunity”: true, “chrome_extension_gmail_enable_email_tools”: true, “enable_desktop_notifications”: true, “default_chrome_extension_enable_reminders”: false, “chrome_extension_gmail_enable_crm_sidebar”: true }, { “id”: “5c1004XXXXXXXXXXXXXXXXXX”, “team_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “first_name”: “Alan”, “last_name”: “Rios”, “title”: null, “email”: “[email protected]”, “created_at”: “2018-12-11T18:40:32.639Z”, “credit_limit”: 50, “direct_dial_credit_limit”: 0, “salesforce_account”: “[email protected]”, “deleted”: false, “should_include_unsubscribe_link”: false, “opt_out_html_template”: “If you don’t want to hear from me again, please <%let me know%>.”, “name”: “Alan Rios”, “enable_click_tracking”: true, “password_needs_reset”: false, “salesforce_id”: “0051XXXXXXXXXXXXXX”, “default_cockpit_layout”: “5c1004XXXXXXXXXXXXXXXXXX”, “default_finder_view_ids”: {}, “default_account_overview_layout_id”: null, “default_organization_overview_layout_id”: null, “default_contact_overview_layout_id”: null, “bridge_calls”: false, “bridge_phone_number”: null, “bridge_incoming_calls”: false, “bridge_incoming_phone_number”: “+1 (408) 201-2216”, “current_email_verified”: true, “record_calls”: true, “salesforce_instance_url”: “https://na85.salesforce.com”, “permission_set_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “assistant_setting”: { “_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “deal_size_metric”: “amount”, “inactive_account_stage_ids”: [], “inactive_contact_stage_ids”: [], “insight_deal_size_signals”: {}, “insight_sale_cycle_signals”: {}, “insight_win_rate_signals”: {}, “job_posting_locations”: [], “job_posting_titles”: [], “latest_funding_days”: 90, “latest_news_days”: 30, “max_num_active_accounts”: 100, “max_people_in_sequence_per_account”: 5, “num_inactive_days_to_re_engage”: 180, “persona_ids”: [ “5c1004XXXXXXXXXXXXXXXXXX”, “5c1004XXXXXXXXXXXXXXXXXX” ], “success_case_account_stage_ids”: [], “technology_uids”: [], “territory_company_size_ranges”: [], “territory_location_override”: false, “territory_locations”: [ “United States” ], “territory_person_locations”: [ “United States” ], “id”: “5c1004XXXXXXXXXXXXXXXXXX”, “key”: “5c1004XXXXXXXXXXXXXXXXXX” }, “typed_custom_fields”: {}, “default_use_local_numbers”: false, “disable_email_linking”: null, “sync_salesforce_id”: “0051UXXXXXXXXXXXXXX”, “sync_crm_id”: null, “zp_contact_id”: “5a9de5XXXXXXXXXXXXXXXXXX”, “chrome_extension_downloaded”: true, “user_roles”: [ “admin” ], “email_oauth_signin_only”: false, “notification_last_created_at”: “2019-11-06T22:48:12.812+00:00”, “crm_requested_to_integrate”: null, “has_invited_user”: false, “notification_last_read_at”: “2019-09-25T18:09:05.000+00:00”, “daily_data_request_email”: true, “data_request_emails”: true, “daily_task_email”: true, “free_data_credits_email”: true, “dismiss_new_team_suggestion”: true, “request_email_change_to”: null, “self_identified_persona”: null, “subteam_ids”: [], “prospect_territory_ids”: [], “linked_salesforce”: true, “linked_hubspot”: false, “linked_salesloft”: true, “default_chrome_extension_log_email_send_to_salesforce”: true, “chrome_extension_auto_match_salesforce_opportunity”: true, “chrome_extension_gmail_enable_email_tools”: true, “enable_desktop_notifications”: true, “default_chrome_extension_enable_reminders”: false, “chrome_extension_gmail_enable_crm_sidebar”: true } ], “num_fetch_result”: null }

GET https://api.apollo.io/v1/users/search

Get a List of Email Accounts

curl -X GET -H “Content-Type: application/json” -H “Cache-Control: no-cache” “https://api.apollo.io/v1/email_accounts?api_key=YOUR_API_KEY_HERE” import requests url = “https://api.apollo.io/v1/email_accounts” querystring = { “api_key”: “YOUR API KEY HERE” } headers = { ‘Cache-Control’: ‘no-cache’, ‘Content-Type’: ‘application/json’ } response = requests.request(“GET”, url, headers=headers, params=querystring) print(response.text)

{ “email_accounts”: [ { “aliases”: [ “[email protected]” ], “id”: “5a298fXXXXXXXXXXXXXXXXXX”, “user_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “email”: “[email protected]”, “type”: “gmail”, “active”: true, “default”: true, “seconds_delay_between_emails”: 0, “provider_display_name”: “Gmail”, “nylas_provider”: null, “last_synced_at”: “2020-08-18T06:28:04.028+00:00”, “email_sending_policy_cd”: “default”, “sendgrid_api_user”: null, “mailgun_domains”: null, “signature_edit_disabled”: true, “email_daily_threshold”: 100, “max_outbound_emails_per_hour”: 50, “signature_html”: “null” } ] }

GET https://api.apollo.io/v1/email_accounts

curl -X GET -H “Content-Type: application/json” -H “Cache-Control: no-cache” “https://api.apollo.io/v1/labels?api_key=YOUR_API_KEY_HERE” import requests url = “https://api.apollo.io/v1/labels” querystring = { “api_key”: “YOUR API KEY HERE” } headers = { ‘Cache-Control’: ‘no-cache’, ‘Content-Type’: ‘application/json’ } response = requests.request(“GET”, url, headers=headers, params=querystring) print(response.text)

[ { “_id”: “5f21ccXXXXXXXXXXXXXXXXXX”, “cached_count”: 5, “created_at”: “2020-07-29T19:23:14.220Z”, “modality”: “contacts”, “name”: “test API label”, “team_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “updated_at”: “2020-08-04T18:16:32.733Z”, “user_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “id”: “5f21ccXXXXXXXXXXXXXXXXXX”, “key”: “5f21ccXXXXXXXXXXXXXXXXXX” }, { “_id”: “5dc34dXXXXXXXXXXXXXXXXXX”, “cached_count”: 0, “created_at”: “2019-11-06T22:48:53.173Z”, “modality”: “contacts”, “name”: “Test”, “team_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “updated_at”: “2020-07-29T19:23:14.308Z”, “user_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “id”: “5dc34dXXXXXXXXXXXXXXXXXX”, “key”: “5dc34dXXXXXXXXXXXXXXXXXX” }, { “_id”: “5cd9eeXXXXXXXXXXXXXXXXXX”, “cached_count”: 3001, “created_at”: “2019-05-13T22:22:30.843Z”, “modality”: “contacts”, “name”: “Test List 1000 Net New Contacts”, “team_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “updated_at”: “2019-05-13T23:38:49.323Z”, “user_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “id”: “5cd9eeXXXXXXXXXXXXXXXXXX”, “key”: “5cd9eeXXXXXXXXXXXXXXXXXX” } ]

GET https://api.apollo.io/v1/labels

Get a List of All Custom Fields

curl -X GET -H “Content-Type: application/json” -H “Cache-Control: no-cache” “https://api.apollo.io/v1/typed_custom_fields?api_key=YOUR_API_KEY_HERE” import requests url = “https://api.apollo.io/v1/typed_custom_fields” querystring = { “api_key”: “YOUR API KEY HERE” } headers = { ‘Cache-Control’: ‘no-cache’, ‘Content-Type’: ‘application/json’ } response = requests.request(“GET”, url, headers=headers, params=querystring) print(response.text)

{ “typed_custom_fields”: [ { “id”: “5c1004XXXXXXXXXXXXXXXXXX”, “modality”: “opportunity”, “name”: “Lead Source”, “type”: “picklist”, “picklist_options”: [], “mapped_crm_field”: “LeadSource”, “additional_mapped_crm_field”: null, “is_readonly_mapped_crm_field”: false, “picklist_options_last_synced_at”: “2020-08-17T08:56:24.973+00:00”, “picklist_value_set_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “mirrored”: false, “system_name”: “lead_source”, “text_field_max_length”: null, “picklist_values”: [ { “_id”: “5c1422XXXXXXXXXXXXXXXXXX”, “mapped_crm_values”: { “5c1004XXXXXXXXXXXXXXXXXX”: “Web” }, “name”: “Web”, “id”: “5c1422XXXXXXXXXXXXXXXXXX”, “key”: “5c1422XXXXXXXXXXXXXXXXXX” }, { “_id”: “5c1422XXXXXXXXXXXXXXXXXX”, “mapped_crm_values”: { “5c1004XXXXXXXXXXXXXXXXXX”: “Phone Inquiry” }, “name”: “Phone Inquiry”, “id”: “5c1422XXXXXXXXXXXXXXXXXX”, “key”: “5c1422XXXXXXXXXXXXXXXXXX” }, { “_id”: “5c1422XXXXXXXXXXXXXXXXXX”, “mapped_crm_values”: { “5c1004XXXXXXXXXXXXXXXXXX”: “Partner Referral” }, “name”: “Partner Referral”, “id”: “5c1422XXXXXXXXXXXXXXXXXX”, “key”: “5c1422XXXXXXXXXXXXXXXXXX” }, { “_id”: “5c1422XXXXXXXXXXXXXXXXXX”, “mapped_crm_values”: { “5c1004XXXXXXXXXXXXXXXXXX”: “Purchased List” }, “name”: “Purchased List”, “id”: “5c1422XXXXXXXXXXXXXXXXXX”, “key”: “5c1422XXXXXXXXXXXXXXXXXX” }, { “_id”: “5c1422XXXXXXXXXXXXXXXXXX”, “mapped_crm_values”: { “5c1004XXXXXXXXXXXXXXXXXX”: “Other” }, “name”: “Other”, “id”: “5c1422XXXXXXXXXXXXXXXXXX”, “key”: “5c1422XXXXXXXXXXXXXXXXXX” } ] }, { “id”: “5c1004XXXXXXXXXXXXXXXXXX”, “modality”: “opportunity”, “name”: “Type”, “type”: “picklist”, “picklist_options”: [], “mapped_crm_field”: “Type”, “additional_mapped_crm_field”: null, “is_readonly_mapped_crm_field”: false, “picklist_options_last_synced_at”: “2020-08-17T08:56:24.975+00:00”, “picklist_value_set_id”: “5c1004XXXXXXXXXXXXXXXXXX”, “mirrored”: false, “system_name”: “type”, “text_field_max_length”: null, “picklist_values”: [ { “_id”: “5c1422XXXXXXXXXXXXXXXXXX”, “mapped_crm_values”: { “5c1004XXXXXXXXXXXXXXXXXX”: “Existing Customer – Upgrade” }, “name”: “Existing Customer – Upgrade”, “id”: “5c1422XXXXXXXXXXXXXXXXXX”, “key”: “5c1422XXXXXXXXXXXXXXXXXX” }, { “_id”: “5c1422XXXXXXXXXXXXXXXXXX”, “mapped_crm_values”: { “5c1004XXXXXXXXXXXXXXXXXX”: “Existing Customer – Replacement” }, “name”: “Existing Customer – Replacement”, “id”: “5c1422XXXXXXXXXXXXXXXXXX”, “key”: “5c1422XXXXXXXXXXXXXXXXXX” }, { “_id”: “5c1422XXXXXXXXXXXXXXXXXX”, “mapped_crm_values”: { “5c1004XXXXXXXXXXXXXXXXXX”: “Existing Customer – Downgrade” }, “name”: “Existing Customer – Downgrade”, “id”: “5c1422XXXXXXXXXXXXXXXXXX”, “key”: “5c1422XXXXXXXXXXXXXXXXXX” }, { “_id”: “5c1422XXXXXXXXXXXXXXXXXX”, “mapped_crm_values”: { “5c1004XXXXXXXXXXXXXXXXXX”: “New Customer” }, “name”: “New Customer”, “id”: “5c1422XXXXXXXXXXXXXXXXXX”, “key”: “5c1422XXXXXXXXXXXXXXXXXX” } ] }, { “id”: “5c8bdaXXXXXXXXXXXXXXXXXX”, “modality”: “contact”, “name”: “User Lookup”, “type”: “lookup_user”, “picklist_options”: [], “mapped_crm_field”: “User_Lookup__c”, “additional_mapped_crm_field”: null, “is_readonly_mapped_crm_field”: false, “picklist_options_last_synced_at”: “2019-03-15T17:00:14.000+00:00”, “picklist_value_set_id”: null, “mirrored”: false, “system_name”: null, “text_field_max_length”: null }, { “id”: “5c4f9XXXXXXXXXXXXXXXXXX”, “modality”: “contact”, “name”: “Custom list”, “type”: “string”, “picklist_options”: [], “mapped_crm_field”: “Custom_List__c”, “additional_mapped_crm_field”: null, “is_readonly_mapped_crm_field”: false, “picklist_options_last_synced_at”: “2019-01-29T00:21:38.000+00:00”, “picklist_value_set_id”: null, “mirrored”: false, “system_name”: null, “text_field_max_length”: null }, { “id”: “5d856XXXXXXXXXXXXXXXXXX”, “modality”: “contact”, “name”: “Full Name Formula Field”, “type”: “string”, “picklist_options”: [], “mapped_crm_field”: “Name”, “additional_mapped_crm_field”: “Name”, “is_readonly_mapped_crm_field”: true, “picklist_options_last_synced_at”: “2019-09-21T00:28:11.000+00:00”, “picklist_value_set_id”: null, “mirrored”: false, “system_name”: null, “text_field_max_length”: null }, { “id”: “5e5849XXXXXXXXXXXXXXXXXX”, “modality”: “contact”, “name”: “Read-only field”, “type”: “string”, “picklist_options”: [], “mapped_crm_field”: “AssistantName”, “additional_mapped_crm_field”: null, “is_readonly_mapped_crm_field”: true, “picklist_options_last_synced_at”: “2020-02-27T22:59:50.000+00:00”, “picklist_value_set_id”: null, “mirrored”: false, “system_name”: null, “text_field_max_length”: null } ] }

GET https://api.apollo.io/v1/typed_custom_fields

Get a List of Opportunity Stages

curl -X GET -H “Content-Type: application/json” -H “Cache-Control: no-cache” “https://api.apollo.io/v1/opportunity_stages?api_key=YOUR_API_KEY_HERE” import requests url = “https://api.apollo.io/v1/opportunity_stages” querystring = { “api_key”: “YOUR API KEY HERE” } headers = { ‘Cache-Control’: ‘no-cache’, ‘Content-Type’: ‘application/json’ } response = requests.request(“GET”, url, headers=headers, params=querystring) print(response.text)

{ “opportunity_stages”: [ { “id”: “5c14XXXXXXXXXXXXXXXXXXXX”, “team_id”: “5c10XXXXXXXXXXXXXXXXXXXX”, “name”: “Negotiation/Review”, “display_order”: 0.0, “forecast_category_cd”: “Pipeline”, “is_won”: false, “is_closed”: false, “probability”: 90.0, “description”: null, “salesforce_id”: “01XXXXXXXXXX”, “type”: “Open” }, { “team_id”: “5c10XXXXXXXXXXXXXXXXXXXX”, “team_id”: “5c10XXXXXXXXXXXXXXXXXXXX”, “name”: “Commit”, “display_order”: 2.0, “forecast_category_cd”: “Committed”, “is_won”: false, “is_closed”: false, “probability”: 90.0, “description”: “Self-explanatory”, “salesforce_id”: null, “type”: “Open” }, { “team_id”: “5c10XXXXXXXXXXXXXXXXXXXX”, “team_id”: “5c10XXXXXXXXXXXXXXXXXXXX”, “name”: “Closed Won”, “display_order”: 3.0, “forecast_category_cd”: “Closed”, “is_won”: true, “is_closed”: true, “probability”: 100.0, “description”: “Self-explanatory”, “salesforce_id”: “01J1UXXXXXXXXXX”, “type”: “Closed/Won” }, { “team_id”: “5c10XXXXXXXXXXXXXXXXXXXX”, “team_id”: “5c10XXXXXXXXXXXXXXXXXXXX”, “name”: “Closed Lost”, “display_order”: 4.0, “forecast_category_cd”: “Omitted”, “is_won”: false, “is_closed”: true, “probability”: 0.0, “description”: “Self-explanatory”, “salesforce_id”: “0XX1U00XXXXXXXXXAC”, “type”: “Closed/Lost” } ] }

GET https://api.apollo.io/v1/opportunity_stages

Source

Bulk People Enrichment

Credit Usage

Rate Limits

Request Parameters

Bulk Organization Enrichment

Credit Usage

Rate Limits

Request Parameters

People Enrichment

Query Parameters

Organization Enrichment

Query Parameters

Search

Query Parameters

Return Results

Organization Jobs Postings

Query Parameters

Create Opportunity

Get all Opportunities

View Opportunity

Update Opportunity

Query Parameters

Query Parameters

Create an Account

Update an Account

Search for Accounts

Get a List of Account Stages

Update Account Stage

Query Parameters

Update Account Ownership

Query Parameters

Search for sequences

Creating a task

Getting a list of tasks

Get a List of Users

Get a List of Email Accounts

Get a List of All Custom Fields

Get a List of Opportunity Stages

Related Posts

Leave a Reply Cancel reply