# Apollo API Documentation Documentation
## Guides
- [Apollo API FAQs](https://docs.apollo.io/docs/apollo-api-faqs.md)
- [APIs Overview](https://docs.apollo.io/docs/api-overview.md)
- [API Pricing](https://docs.apollo.io/docs/api-pricing.md)
- [Create API Keys](https://docs.apollo.io/docs/create-api-key.md)
- [Test API Key](https://docs.apollo.io/docs/test-api-key.md)
- [OAuth 2.0 (Partners)](https://docs.apollo.io/docs/use-oauth-20-authorization-flow-to-access-apollo-user-information-partners.md)
- [Feature Your Integration](https://docs.apollo.io/docs/add-your-integration-to-apollos-marketplace.md)
- [Set Up Your Marketplace Listing](https://docs.apollo.io/docs/set-up-your-marketplace-listing.md)
- [Convert Enriched People to Contacts](https://docs.apollo.io/docs/convert-enriched-people-to-contacts.md)
- [Enrich People Data](https://docs.apollo.io/docs/enrich-people-data.md)
- [Enrich Contact Emails and Phone Numbers with Waterfall Enrichment](https://docs.apollo.io/docs/enrich-phone-and-email-using-data-waterfall.md)
- [Find People Using Filters](https://docs.apollo.io/docs/find-people-using-filters.md)
- [Overview - Apollo API Tutorials](https://docs.apollo.io/docs/overview-apollo-api-tutorials.md)
- [Retrieve LinkedIn Profiles for Prospects](https://docs.apollo.io/docs/retrieve-linkedin-profiles-for-prospects.md)
- [Retrieve Mobile Phone Numbers for Contacts](https://docs.apollo.io/docs/retrieve-mobile-phone-numbers-for-contacts.md)
## API Reference
- [Bulk Create Accounts](https://docs.apollo.io/reference/bulk-create-accounts.md): Use the Bulk Create Accounts endpoint to create up to 100 accounts in a single API request. This endpoint supports intelligent deduplication and returns separate arrays for newly created and existing accounts.
Important: This endpoint creates new accounts but does NOT update existing ones. Existing accounts that match the criteria will be returned in the existing_accounts array without modification.
To update existing accounts, use the Bulk Update Accounts endpoint.
- [Bulk Update Accounts](https://docs.apollo.io/reference/bulk-update-accounts.md): Use the Bulk Update Accounts endpoint to simultaneously update multiple accounts in your team's Apollo account.
This endpoint allows you to update common fields across multiple accounts efficiently, such as account stages, owners, names, and custom fields.
You can update up to 1000 accounts per request.
Important: Asynchronous processing (async parameter) is only supported when using account_ids to apply the same updates to all accounts. If you attempt to use async with account_attributes (individual updates per account), the request will fail with a 422 error.
- [Create an Account](https://docs.apollo.io/reference/create-an-account.md): Use the Create an Account endpoint to add a new account to your team's Apollo account.
In Apollo terminology, an account is a company that your team has explicitly added to your database.
Apollo does not apply deduplication processes when you create a new account via the API. If your entry has the same name, domain, or other details as an existing account, Apollo will create a new account instead of updating the existing account. To update an existing account, use the Update an Account endpoint instead.
This endpoint requires a master API key. If you attempt to call the endpoint without a master key, you will receive a `403` response. Refer to Create API Keys to learn how to create a master API key.
- [List Account Stages](https://docs.apollo.io/reference/list-account-stages.md): Use the List Accounts Stages endpoint to retrieve the IDs for the available account stages in your team's Apollo account. This endpoint does not require parameters.
Account stage IDs can be used to update individual accounts and update the account stages for multiple accounts via the Apollo API.
This endpoint requires a master API key. If you attempt to call the endpoint without a master key, you will receive a `403` response. Refer to Create API Keys to learn how to create a master API key.
- [Search for Accounts](https://docs.apollo.io/reference/search-for-accounts.md): Use the Search for Accounts endpoint to search for the account that have been added to your team's Apollo account.
In Apollo terminology, an account is a company that your team has explicitly added to your database.
This endpoint only returns accounts in the search results. To search for companies in the Apollo database, call the Organization Search endpoint.
To protect Apollo's performance for all users, this endpoint has a display limit of 50,000 records (100 records per page, up to 500 pages). Add more filters to narrow your search results as much as possible. This limitation does not restrict your access to Apollo's database; you just need to access the data in batches.
- [Update Account Owner for Multiple Accounts](https://docs.apollo.io/reference/update-account-ownership.md): Use the Update Account Owner for Multiple Accounts endpoint to assign multiple accounts to a different user in your team's Apollo account.
To update more than the account owner, such as domains or phone numbers, use the Update an Account endpoint instead.
This endpoint requires a master API key. If you attempt to call the endpoint without a master key, you will receive a `403` response. Refer to Create API Keys to learn how to create a master API key.
- [Update Account Stage for Multiple Accounts](https://docs.apollo.io/reference/update-account-stage.md): Use the Update Account Stage for Multiple Accounts endpoint to update the account stage for several account in your team's Apollo account.
To update more than the account stage, such as domains or phone numbers, use the Update an Account endpoint instead.
This endpoint requires a master API key. If you attempt to call the endpoint without a master key, you will receive a `403` response. Refer to Create API Keys to learn how to create a master API key.
- [Update an Account](https://docs.apollo.io/reference/update-an-account.md): Use the Update an Account endpoint to update existing accounts in your team's Apollo account.
In Apollo terminology, an account is a company that your team has explicitly added to your database.
To create a new account, use the Create an Account endpoint instead. To update the account stage for multiple account, use the Update Account Stage for Multiple Accounts endpoint.
This endpoint requires a master API key. If you attempt to call the endpoint without a master key, you will receive a `403` response. Refer to Create API Keys to learn how to create a master API key.
- [View an Account](https://docs.apollo.io/reference/view-an-account.md): Use the View an Account endpoint to retrieve details for an existing account in your team's Apollo database. In Apollo terminology, an account is a company that your team has explicitly added to your database.
This endpoint requires a master API key. If you attempt to call the endpoint without a master key, you will receive a `403` response. Refer to Create API keys to learn how to create a master API key.
- [Authentication](https://docs.apollo.io/reference/authentication.md)
- [How to Test API Endpoints](https://docs.apollo.io/reference/how-to-test-api-endpoints.md)
- [Rate Limits](https://docs.apollo.io/reference/rate-limits.md)
- [Status Codes / Errors](https://docs.apollo.io/reference/status-codes.md)
- [Create Call Records](https://docs.apollo.io/reference/create-call-records.md): Use the Create Call Records endpoint to log calls in Apollo that were made using outside systems such as Orum or Nooks. This endpoint can only be used create call records, not to dial prospects.
This endpoint requires a master API key. If you attempt to call the endpoint without a master key, you will receive a `403` response. Refer to Create API Keys to learn how to create a master API key.
- [Search for Calls](https://docs.apollo.io/reference/search-for-calls.md): Use the Search for Calls endpoint to find calls that your team has made or received using the Apollo dialer.
This endpoint requires a master API key. If you attempt to call the endpoint without a master key, you will receive a `403` response. Refer to Create API Keys to learn how to create a master API key.
- [Update Call Records](https://docs.apollo.io/reference/update-call-records.md): Use the Update Call Records endpoint to update your team's call records in Apollo.
This endpoint requires a master API key. If you attempt to call the endpoint without a master key, you will receive a `403` response. Refer to Create API Keys to learn how to create a master API key.
- [Bulk Create Contacts](https://docs.apollo.io/reference/bulk-create-contacts.md): Use the Bulk Create Contacts endpoint to create up to 100 contacts in a single API request. This endpoint supports intelligent deduplication and returns separated arrays for newly created and existing contacts.
Important: This endpoint creates new contacts but does NOT update existing ones (except for placeholder contacts from email imports). Existing contacts that match the criteria will be returned in the existing_contacts array without modification.
To update existing contacts, use the Bulk Update Contacts endpoint.
- [Bulk Update Contacts](https://docs.apollo.io/reference/bulk-update-contacts.md): Use the Bulk Update Contacts endpoint to update multiple contacts in your team's Apollo account simultaneously.
This endpoint allows you to update common fields across multiple contacts efficiently, such as contact stages, owners, custom fields, and other contact attributes.
You can update up to 100 contacts per request. For larger batches, the system will process the updates asynchronously.
- [Create a Contact](https://docs.apollo.io/reference/create-a-contact.md): Use the Create a Contact endpoint to add a new contact to your team's Apollo account.
In Apollo terminology, a contact is a person that your team has explicitly added to your database. A contact will have their data enriched in some way, such as accessing an email address or a phone number.
By default, Apollo does not apply deduplication processes when you create a new contact via the API. If your entry has the same name, email address, or other details as an existing contact, Apollo will create a new contact instead of updating the existing contact. To enable deduplication and prevent duplicate contacts, set the run_dedupe parameter to true.
To update an existing contact, use the Update a Contact endpoint instead.
- [List Contact Stages](https://docs.apollo.io/reference/list-contact-stages.md): Use the List Contact Stages endpoint to retrieve the IDs for the available contact stages in your team's Apollo account.
Contact stage IDs can be used to update invidual contacts and update the contact stages for multiple contacts via the Apollo API.
- [Search for Contacts](https://docs.apollo.io/reference/search-for-contacts.md): Use the Search for Contacts endpoint to search for the contacts that have been added to your team's Apollo account.
In Apollo terminology, a contact is a person that your team has explicitly added to your database. A contact will have their data enriched in some way, such as accessing an email address or a phone number.
This endpoint only returns contacts in the search results. To search for people in the Apollo database, call the People API Search endpoint.
To protect Apollo's performance for all users, this endpoint has a display limit of 50,000 records (100 records per page, up to 500 pages). Add more filters to narrow your search results as much as possible. This limitation does not restrict your access to Apollo's database; you just need to access the data in batches.
- [Update a Contact](https://docs.apollo.io/reference/update-a-contact.md): Use the Update a Contact endpoint to update existing contacts in your team's Apollo account.
In Apollo terminology, a contact is a person that your team has explicitly added to your database. A contact will have their data enriched in some way, such as accessing an email address or a phone number.
To create a new contact, use the Create a Contact endpoint instead. To update the contact stage for multiple contacts, use the Update Contact Stage for Multiple Contacts endpoint.
- [Update Contact Owner for Multiple Contacts](https://docs.apollo.io/reference/update-contact-ownership.md): Use the Update Contact Owner for Multiple Contacts endpoint to assign multiple contacts to a different user in your team's Apollo account.
To update more than the contact's owner, such as job titles or contact details, use the Update a Contact endpoint instead.
- [Update Contact Stage for Multiple Contacts](https://docs.apollo.io/reference/update-contact-stage.md): Use the Update Contact Stage for Multiple Contacts endpoint to update the contact stage for several contacts in your team's Apollo account.
To update more than the contact stage, such as job titles or contact details, use the Update a Contact endpoint instead.
- [View a Contact](https://docs.apollo.io/reference/view-a-contact.md): Use the View a Contact endpoint to retrieve details for an existing contact in your team's Apollo database. In Apollo terminology, a contact is a person that your team has explicitly added to your database. A contact will have their data enriched in some way, such as accessing an email address or a phone number.
This endpoint requires a master API key. If you attempt to call the endpoint without a master key, you will receive a `403` response. Refer to Create API Keys to learn how to create a master API key.
- [Create Deal](https://docs.apollo.io/reference/create-deal.md): Use the Create Deal endpoint to create new deals for an Apollo account. Deals enable you to track account activity, including monetary values of a deal, deal owners, and deal stages.
To update existing deals in your Apollo account, use the Update Deal endpoint instead.
This endpoint also requires a master API key. If you attempt to call the endpoint without a master key, you will receive a `403` response. Refer to Create API Keys to learn how to create a master API key.
- [List All Deals](https://docs.apollo.io/reference/list-all-deals.md): Use the List All Deals endpoint to retrieve every deal that has been created for your team's Apollo account.
This endpoint also requires a master API key. If you attempt to call the endpoint without a master key, you will receive a `403` response. Refer to Create API Keys to learn how to create a master API key.
- [List Deal Stages](https://docs.apollo.io/reference/list-deal-stages.md): Use the List Deal Stages endpoint to retrieve information about every deal stage that is available in your team's Apollo account.
The `id` value for each deal stage can be used to set the stage when creating a deal or updating a deal via the Apollo API.
This endpoint also requires a master API key. If you attempt to call the endpoint without a master key, you will receive a `403` response. Refer to Create API Keys to learn how to create a master API key.
- [Update Deal](https://docs.apollo.io/reference/update-deal.md): Use the Update Deal endpoint to update the details of existing deals within your team's Apollo account. Deals enable you to track account activity, including monetary values of a deal, deal owners, and deal stages.
To create new deals in your Apollo account, use the Create Deal endpoint instead.
This endpoint also requires a master API key. If you attempt to call the endpoint without a master key, you will receive a `403` response. Refer to Create API Keys to learn how to create a master API key.
- [View Deal](https://docs.apollo.io/reference/view-deal.md): Use the View Deal endpoint to retrieve complete details about a deal within your team's Apollo account.
Deal information can include the ID of the deal owner, the monetary value of the deal, the deal stage, and general details about the account.
This endpoint also requires a master API key. If you attempt to call the endpoint without a master key, you will receive a `403` response. Refer to Create API Keys to learn how to create a master API key.
- [Bulk Organization Enrichment](https://docs.apollo.io/reference/bulk-organization-enrichment.md): Use the Bulk Organization Enrichment endpoint to enrich data for up to 10 companies with a single API call. To enrich data for only 1 company, use the Organization Enrichment endpoint instead.
Enriched data potentially includes industry information, revenue, employee counts, funding round details, and corporate phone numbers and locations.
This endpoint's rate limit is throttled to 50% of the Organization Enrichment endpoint's per-minute rate limit, and is 100% of the hourly and daily rate limits for the same individual endpoint.
- [Bulk People Enrichment](https://docs.apollo.io/reference/bulk-people-enrichment.md): Use the Bulk People Enrichment endpoint to enrich data for up to 10 people with a single API call. To enrich data for only 1 person, use the People Enrichment endpoint instead.
Apollo relies on the information you pass via the endpoint's parameters to identify the correct people to enrich. When you provide more information, Apollo is more likely to find matches within its database. If you only provide general information, such as a name without a domain or email address, you might receive a `200` response, but the response will indicate that no records have been enriched. The details for each person should be passed as an object with the `details[]` array.
By default, this endpoint does not return personal emails or phone numbers. Use the `reveal_personal_emails` and `reveal_phone_number` parameters to retrieve emails and phone numbers. If you set either of these parameters to `true`, Apollo will attempt to provide emails or phone numbers for all matches.
You can use also use the `run_waterfall_email` and `run_waterfall_phone` parameters to run waterfall enrichment via this endpoint. [Waterfall enrichment](https://knowledge.apollo.io/hc/en-us/articles/34071089002509-Waterfall-Enrichment-Overview) gives you broader data coverage by checking connected third-party data sources for contact emails and phone numbers. When you call this endpoint and include at least one waterfall parameter, Apollo returns an immediate synchronous response with demographic and firmographic data, along with a waterfall enrichment request status. Apollo delivers enriched emails and/or phone numbers asynchronously to a configured webhook.
**Webhook Requirements:** - **HTTPS Required:** Your endpoint must be publicly accessible over HTTPS. - **Rate Limiting:** Ensure your webhook endpoint can handle the volume of webhook traffic sent by Apollo. - **Idempotency:** Apollo may retry webhook calls. Your endpoint should be idempotent to handle duplicate payloads safely. Using this endpoint will consume credits based on your account's pricing plan. If you run waterfall enrichment parameters, your [credit usage](https://knowledge.apollo.io/hc/en-us/articles/34071089002509-Waterfall-Enrichment-Overview#does-waterfall-enrichment-require-credits) depends on the type of data you request (emails and/or phone numbers) and which data source returns enriched data. To view a summary of Apollo's pricing, visit the public pricing page ↗ For detailed information regarding API credit usage, see the API enrichment ↗ section on the *About Credits* page (login required).
This endpoint's rate limit is throttled to 50% of the People Enrichment endpoint's per-minute rate limit, and is 100% of the hourly and daily rate limits for the same individual endpoint.
- [Organization Enrichment](https://docs.apollo.io/reference/organization-enrichment.md): Use the Oganization Enrichment endpoint to enrich data for 1 company. To enrich data for up to 10 companies with a single API call, use the Bulk Organization Enrichment endpoint instead.
Enriched data potentially includes industry information, revenue, employee counts, funding round details, and corporate phone numbers and locations.
- [People Enrichment](https://docs.apollo.io/reference/people-enrichment.md): Use the People Enrichment endpoint to enrich data for 1 person. To enrich data for up to 10 people with a single API call, use the Bulk People Enrichment endpoint instead.
Apollo relies on the information you pass via the endpoint's parameters to identify the correct person to enrich. If you provide more information about a person, Apollo is more likely to find a match within its database. If you only provide general information, such as a name without a domain or email address, you might receive a 200 response, but the response will indicate that no records have been enriched.
By default, this endpoint does not return personal emails or phone numbers. Use the `reveal_personal_emails` and `reveal_phone_number` parameters to retrieve emails and phone numbers.
You can also use the `run_waterfall_email` and `run_waterfall_phone` parameters to run waterfall enrichment via this endpoint. [Waterfall enrichment](https://knowledge.apollo.io/hc/en-us/articles/34071089002509-Waterfall-Enrichment-Overview) gives you broader data coverage by checking connected third-party data sources for contact emails and phone numbers. When you call this endpoint and include at least one waterfall parameter, Apollo returns an immediate synchronous response with demographic and firmographic data, along with a waterfall enrichment request status. Apollo delivers enriched emails and/or phone numbers asynchronously to a configured webhook.
**Webhook Requirements:** - **HTTPS Required:** Your endpoint must be publicly accessible over HTTPS. - **Rate Limiting:** Ensure your webhook endpoint can handle the volume of webhook traffic sent by Apollo. - **Idempotency:** Apollo may retry webhook calls; your endpoint should be idempotent to handle duplicate payloads safely. Using this endpoint will consume credits based on your account's pricing plan. If you run waterfall enrichment parameters, your [credit usage](https://knowledge.apollo.io/hc/en-us/articles/34071089002509-Waterfall-Enrichment-Overview#does-waterfall-enrichment-require-credits) depends on the type of data you request (emails and/or phone numbers) and which data source returns enriched data. To view a summary of Apollo's pricing, visit the public pricing page ↗ For detailed information regarding API credit usage, see the API enrichment ↗ section on the *About Credits* page (login required).
- [Create a Custom Field](https://docs.apollo.io/reference/create-a-custom-field.md): The Create a Custom Field endpoint lets you add custom fields to your Apollo account, helping your team capture unique details about contacts, accounts, or deals. Use these fields to enhance your sequences and deliver more personalized, relevant outreach.
- [Get a List of All Custom Fields](https://docs.apollo.io/reference/get-a-list-of-all-custom-fields.md): This endpoint is deprecated. To achieve the same result, use the Fields endpoint (use `source: custom` to get custom fields only)
Use the Get a List of Custom Fields endpoint to retrieve information about all of the custom fields that have been created in your Apollo account.
This endpoint does not require any parameters.
This endpoint requires a master API key. If you attempt to call the endpoint without a master key, you will receive a `403` response. Refer to Create API Keys to learn how to create a master API key.
- [Get a List of All Lists](https://docs.apollo.io/reference/get-a-list-of-all-lists.md): Use the Get a List of All Lists endpoint to retrieve information about every list that has been created in your Apollo account. This endpoint can be used to check the available lists before you use the Create a Contact endpoint.
This endpoint does not require any parameters.
This endpoint requires a master API key. If you attempt to call the endpoint without a master key, you will receive a `403` response. Refer to Create API Keys to learn how to create a master API key.
- [Get a List of Email Accounts](https://docs.apollo.io/reference/get-a-list-of-email-accounts.md): Use the Get a List of Email Accounts endpoint to retrieve information about the linked email inboxes that your teammates use in your Apollo account.
In particular, this endpoint returns IDs for each of your team's linked email accounts, which can be used with the Add Contacts to a Sequence endpoint.
This endpoint does not require any parameters.
This endpoint requires a master API key. If you attempt to call the endpoint without a master key, you will receive a `403` response. Refer to Create API Keys to learn how to create a master API key.
- [Get a List of Fields](https://docs.apollo.io/reference/get-a-list-of-fields.md): Use the Get a List of Fields endpoint to retrieve information about all of the fields that exist in your Apollo account. This endpoint requires a master API key. If you attempt to call the endpoint without a master key, you will receive a `403` response. Refer to Create API Keys to learn how to create a master API key.
- [Get a List of Users](https://docs.apollo.io/reference/get-a-list-of-users.md): Use the Get a List of Users endpoint to retrieve the IDs for all of the users (teammates) in your Apollo account.
These IDs can be used for several other endpoints, including the Create a Deal, Create an Account, and Create a Task endpoints.
This endpoint requires a master API key. If you attempt to call the endpoint without a master key, you will receive a `403` response. Refer to Create API Keys to learn how to create a master API key.
- [View API Usage Stats and Rate Limits](https://docs.apollo.io/reference/view-api-usage-stats.md): Use the View API Usage Stats endpoint to view your team's usage of Apollo's APIs and your rate limit for API endpoints.
Each endpoint has a rate limit per minute, hour, and day. Your Apollo pricing plan does impact the rate limits for API endpoints.
This endpoint requires a master API key. If you attempt to call the endpoint without a master key, you will receive a `403` response. Refer to Create API Keys to learn how to create a master API key.
- [Get Complete Organization Info](https://docs.apollo.io/reference/get-complete-organization-info.md): Use the Get Complete Organization Info endpoint to retrieve complete details about an organization in the Apollo database.
This endpoint requires a master API key. If you attempt to call the endpoint without a master key, you will receive a `403` response. Refer to Create API Keys to learn how to create a master API key.
- [News Articles Search](https://docs.apollo.io/reference/news-articles-search.md): Use the News Articles Search endpoint to find news articles related to companies in the Apollo database. Several filters are available to help narrow your search.
Calling this endpoint does consume credits as part of your Apollo pricing plan.
- [Organization Job Postings](https://docs.apollo.io/reference/organization-jobs-postings.md): Use the Organization Job Postings endpoint to retrieve the current job postings for companies. This can help you identify companies that are growing headcount in areas that are strategically important for you.
Calling this endpoint does consume credits as part of your Apollo pricing plan.
To protect Apollo's performance for all users, this endpoint has a display limit of 10,000 records. This limitation does not restrict your access to Apollo's database; you just need to access the data in batches.
- [Organization Search](https://docs.apollo.io/reference/organization-search.md): Use the Organization Search endpoint to find companies in the Apollo database. Several filters are available to help narrow your search.
Calling this endpoint does consume credits as part of your Apollo pricing plan.
To protect Apollo's performance for all users, this endpoint has a display limit of 50,000 records (100 records per page, up to 500 pages). Add more filters to narrow your search results as much as possible. This limitation does not restrict your access to Apollo's database; you just need to access the data in batches.
- [People API Search](https://docs.apollo.io/reference/people-api-search.md): Use the People API Search endpoint to find net new people in the Apollo database. Several filters are available to help narrow your search.
This endpoint is optimized for API usage and does not consume credits. This endpoint is primarily designed for prospecting net new people.
This endpoint does not return email addresses or phone numbers. Use the People Enrichment or Bulk People Enrichment endpoints to enrich data. This endpoint requires a master API key. Refer to Create API Keys to learn how to create a master API key.
To protect Apollo's performance for all users, this endpoint has a display limit of 50,000 records (100 records per page, up to 500 pages). Add more filters to narrow your search results as much as possible. This limitation does not restrict your access to Apollo's database; you just need to access the data in batches.
- [Add Contacts to a Sequence](https://docs.apollo.io/reference/add-contacts-to-sequence.md): Use the Add Contacts to a Sequence endpoint to add contacts to the existing sequences in your team's Apollo account.
In Apollo terminology, a contact is a person that your team has explicitly added to your database. Only contacts can be added to sequences. To enrich a person's data, call the People Enrichment endpoint. Then, to add the person as a contact in your database, call the Create a Contact endpoint.
This endpoint requires a master API key. If you attempt to call the endpoint without a master key, you will receive a `403` response. Refer to Create API Keys to learn how to create a master API key.
- [Check Email Stats](https://docs.apollo.io/reference/check-email-stats.md): Use the Check Email Stats endpoint to review the complete details for an email sent as part of an Apollo sequence. This includes the contents of the emails, stats related to the email such as opens and clicks, and details about the contact that received the email.
This endpoint requires a master API key. If you attempt to call the endpoint without a master key, you will receive a `403` response. Refer to Create API Keys to learn how to create a master API key.
- [Search for Outreach Emails](https://docs.apollo.io/reference/search-for-outreach-emails.md): Use the Search for Outreach Emails endpoint to find emails that your team has created and sent as part of Apollo sequences.
To protect Apollo's performance for all users, this endpoint has a display limit of 50,000 records (100 records per page, up to 500 pages). Add more filters to narrow your search results as much as possible. This limitation does not restrict your access to Apollo's database; you just need to access the data in batches.
This endpoint requires a master API key. If you attempt to call the endpoint without a master key, you will receive a `403` response. Refer to Create API Keys to learn how to create a master API key.
- [Search for Sequences](https://docs.apollo.io/reference/search-for-sequences.md): Use the Search for Sequences endpoint to search for the sequences that have been created for your team's Apollo account.
This endpoint requires a master API key. If you attempt to call the endpoint without a master key, you will receive a `403` response. Refer to Create API Keys to learn how to create a master API key.
- [Update Contact Status in a Sequence](https://docs.apollo.io/reference/update-contact-status-sequence.md): Use the Update Contact Status in a Sequence endpoint to either mark contacts as having `finished` a sequence, or to remove them from a sequence entirely.
This endpoint requires a master API key. If you attempt to call the endpoint without a master key, you will receive a `403` response. Refer to Create API Keys to learn how to create a master API key.
- [Bulk Create Tasks](https://docs.apollo.io/reference/bulk-create-tasks.md): Use the Bulk Create Tasks endpoint to create multiple tasks in a single API request. A separate task will be created for each contact provided.
This endpoint returns a `success` boolean and a `tasks` array containing the created tasks.
Apollo does not apply deduplication processes when you create a new task via the API. If your entry has the same task owner, contact, and other details as an existing task, Apollo will create a new task instead of updating the existing task.
For creating a single task, use the Create a Task endpoint instead.
This endpoint requires a master API key. If you attempt to call the endpoint without a master key, you will receive a `403` response. Refer to Create API Keys to learn how to create a master API key.
- [Create a Task](https://docs.apollo.io/reference/create-a-task.md): Use the Create a Task endpoint to create a single task in Apollo for you and your team. Tasks help track the upcoming actions you need to take, such as emailing or calling a contact.
This endpoint returns the created task object.
Apollo does not apply deduplication processes when you create a new task via the API. If your entry has the same task owner, contact, and other details as an existing task, Apollo will create a new task instead of updating the existing task.
This endpoint requires a master API key. If you attempt to call the endpoint without a master key, you will receive a `403` response. Refer to Create API Keys to learn how to create a master API key.
- [Search for Tasks](https://docs.apollo.io/reference/search-tasks.md): Use the Search for Tasks endpoint to find tasks that your team has created in Apollo.
To protect Apollo's performance for all users, this endpoint has a display limit of 50,000 records (100 records per page, up to 500 pages). Add more filters to narrow your search results as much as possible. This limitation does not restrict your access to Apollo's database; you just need to access the data in batches.
This endpoint requires a master API key. If you attempt to call the endpoint without a master key, you will receive a `403` response. Refer to Create API Keys to learn how to create a master API key.
## Pages
- [Apollo Marketplace](https://docs.apollo.io/apollo-marketplace.md)