> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Apollo

> Apollo provides CRM and lead generation capabilities, helping businesses discover contacts, manage outreach, and track sales pipelines for consistent customer relationship development

![Apollo logo](https://mintcdn.com/composio-preview/6S5R4NszqpnVIZRD/images/toolkits/apollo.svg?fit=max\&auto=format\&n=6S5R4NszqpnVIZRD\&q=85\&s=a8d32b62848d5bdc7e9ea357c425cebe)

* **Category:** people & contact data
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 72
* **Triggers:** 0
* **Slug:** `APOLLO`
* **Version:** 20261101\_00
* **Instant:** Supported on the latest version. Support varies by tool.

## Frequently Asked Questions

> [accordion] Why can Apollo search or enrichment tools return HTTP 403?
>
> Apollo API keys can be limited to specific endpoint groups. A tool can return HTTP 403 or `Forbidden` when the underlying Apollo API rejects the key for that operation, even if the same key works for other Apollo tools.
>
> This can affect gated search, enrichment, usage, and outreach tools such as `APOLLO_PEOPLE_SEARCH`, `APOLLO_ORGANIZATION_SEARCH`, `APOLLO_SEARCH_ACCOUNTS`, `APOLLO_SEARCH_OUTREACH_EMAILS`, `APOLLO_PEOPLE_ENRICHMENT`, `APOLLO_BULK_PEOPLE_ENRICHMENT`, `APOLLO_ORGANIZATION_ENRICHMENT`, `APOLLO_BULK_ORGANIZATION_ENRICHMENT`, and `APOLLO_VIEW_API_USAGE_STATS`.
>
> In Apollo, make sure the API key has access to the relevant endpoint group or has **Set as master key** turned on. If the Apollo plan does not include the requested API feature, the tool can still return 403 until that access is enabled in Apollo.

## Tools

> [accordion] Activate Sequence
>
> **Slug:** `APOLLO_ACTIVATE_SEQUENCE`
>
> Activate an inactive Apollo sequence and begin its scheduled outreach. Activation allows Apollo to send emails externally to enrolled contacts according to the sequence's configured steps and schedule. Reference: [https://docs.apollo.io/reference/approve-sequence](https://docs.apollo.io/reference/approve-sequence)
>
> #### Input Parameters
>
> **sequence\_id** `string` *required*
>
> Apollo ID of the inactive sequence to activate. The sequence must contain at least one step.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add Contacts to Sequence
>
> **Slug:** `APOLLO_ADD_CONTACTS_TO_SEQUENCE`
>
> Adds contacts to a specified Apollo email sequence and returns the contact details. `sequence_id`, `emailer_campaign_id`, and `send_email_from_email_account_id` must be retrieved from Apollo listing/search endpoints before calling this tool — these IDs cannot be inferred from names.
>
> #### Input Parameters
>
> **user\_id** `string`
>
> Optional unique ID of the user performing the action (in request body if specified).
>
> **contact\_ids** `array` *required*
>
> List of unique Apollo contact IDs to add to the sequence (in request body).
>
> **sequence\_id** `string` *required*
>
> Unique ID of the Apollo sequence to add contacts to (path parameter).
>
> **sequence\_no\_email** `boolean`
>
> If true, add contacts without an email address (query parameter).
>
> **emailer\_campaign\_id** `string` *required*
>
> Unique ID of the Apollo emailer campaign (should match `sequence_id`; in request body).
>
> **sequence\_job\_change** `boolean`
>
> If true, add contacts who recently changed jobs (query parameter).
>
> **sequence\_unverified\_email** `boolean`
>
> If true, add contacts with unverified emails (query parameter).
>
> **send\_email\_from\_email\_account\_id** `string` *required*
>
> Unique ID of the Apollo email account for sending emails (in request body).
>
> **sequence\_active\_in\_other\_campaigns** `boolean`
>
> If true, add contacts active in other sequences (query parameter).
>
> **sequence\_finished\_in\_other\_campaigns** `boolean`
>
> If true, add contacts finished in other sequences (query parameter).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add People to Prospects
>
> **Slug:** `APOLLO_ADD_PEOPLE_TO_PROSPECTS`
>
> Save Apollo person IDs returned by APOLLO\_PEOPLE\_SEARCH as persistent prospect contacts. Unlike APOLLO\_CREATE\_CONTACT, this converts existing Apollo search results instead of creating a contact from caller-supplied attributes. Requires a paid Apollo plan. Apollo can also create an associated account record, which its API cannot delete; obtain explicit user confirmation before execution.
>
> #### Input Parameters
>
> **entity\_ids** `array` *required*
>
> Non-empty list of Apollo person IDs returned by APOLLO\_PEOPLE\_SEARCH to save as persistent prospect contacts.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Archive Sequence
>
> **Slug:** `APOLLO_ARCHIVE_SEQUENCE`
>
> Archive an Apollo sequence, making it inactive and finishing all enrolled contacts. This lifecycle change can end outreach for every contact currently in the sequence. The caller must own the sequence or have full-access sharing permission. Reference: [https://docs.apollo.io/reference/archive-sequence](https://docs.apollo.io/reference/archive-sequence)
>
> #### Input Parameters
>
> **sequence\_id** `string` *required*
>
> Apollo ID of the sequence to archive. Archiving makes the sequence inactive and finishes all contacts currently enrolled in it.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Bulk organization enrichment
>
> **Slug:** `APOLLO_BULK_ORGANIZATION_ENRICHMENT`
>
> Enriches data for up to 10 organizations simultaneously by providing a list of their base company domains (e.g., 'apollo.io', not '[www.apollo.io](http://www.apollo.io)'). Charged per domain enriched.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** Estimated \$0.02 per organization enriched in the batch
>
> #### Input Parameters
>
> **domains** `array` *required*
>
> List of 1-10 company domains to enrich. Domains should be base domains (e.g., 'apollo.io') and not include '[www](http://www).', '@', or protocols like 'http\://'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Bulk people enrichment
>
> **Slug:** `APOLLO_BULK_PEOPLE_ENRICHMENT`
>
> Enriches up to 10 person profiles from Apollo's database; charges may apply per person enriched, and unmatched entries may be null. Managed calls support base enrichment only and reject personal email or phone reveal and webhook delivery.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.02–\$0.18 per person enriched; waterfall may cost more.
>
> #### Input Parameters
>
> **details** `array` *required*
>
> List of 1-10 person objects to enrich. At least one person is required. For effective matching, include key identifiers like email, LinkedIn URL, or name plus company information. Exceeding 10 objects causes 400/422 errors; chunk larger lists into batches of ≤10.
>
> **webhook\_url** `string`
>
> Webhook URL for phone number delivery if `reveal_phone_number` is true; mandatory in that case. URL must be publicly reachable; inaccessible URLs silently prevent phone data delivery.
>
> **reveal\_phone\_number** `boolean`
>
> If true, enriches with all available phone numbers; increases the price and requires 'webhook\_url'.
>
> **reveal\_personal\_emails** `boolean`
>
> If true, enriches with personal emails; increases the price.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Bulk update account stage
>
> **Slug:** `APOLLO_BULK_UPDATE_ACCOUNT_STAGE`
>
> Bulk updates the stage for specified existing Apollo.io accounts, moving them to a valid new account stage.
>
> #### Input Parameters
>
> **account\_ids** `array` *required*
>
> A list of unique identifiers for accounts whose stage needs to be updated.
>
> **account\_stage\_id** `string` *required*
>
> The unique identifier of the account stage to which the specified accounts will be moved.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Complete Apollo Task
>
> **Slug:** `APOLLO_COMPLETE_TASK`
>
> Requests completion of an Apollo task and returns the resulting task state. Check the returned state: Apollo can return a deleted task with HTTP 200.
>
> #### Input Parameters
>
> **task\_id** `string` *required*
>
> The Apollo ID of the task to mark as completed. Use the Search Tasks action to find task IDs.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create an Apollo account
>
> **Slug:** `APOLLO_CREATE_ACCOUNT`
>
> Creates a new account in Apollo.io; a new record is created even if a similar account exists, and provided `owner_id` or `account_stage_id` must be valid existing IDs. The response includes the new account's ID, which can be used directly in subsequent calls.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Human-readable name for the account.
>
> **phone** `string`
>
> Primary phone number for the account (e.g., main corporate line, branch, or direct dial).
>
> **domain** `string`
>
> Company's primary domain name (e.g., 'apollo.io', not '[www.apollo.io](http://www.apollo.io)') to help Apollo enrich account data.
>
> **owner\_id** `string`
>
> Unique ID of the user within your Apollo team to be assigned as owner; retrieve via the 'Get a List of Users' endpoint.
>
> **raw\_address** `string`
>
> Physical address or general location of the account (e.g., full street address or 'City, State, Country').
>
> **account\_stage\_id** `string`
>
> Unique ID for the account's sales stage (e.g., 'Prospecting' or 'Closed Won'); retrieve via the 'List Account Stages' endpoint.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Bulk create Apollo accounts
>
> **Slug:** `APOLLO_CREATE_BULK_ACCOUNTS`
>
> Creates multiple accounts in Apollo.io with a single API call (maximum 100 accounts per request). Use when creating multiple company records at once.
>
> #### Input Parameters
>
> **accounts** `array` *required*
>
> Array of account objects to create (maximum 100 accounts per request). Each account should have at least a name or domain.
>
> **run\_dedupe** `boolean`
>
> Enable aggressive deduplication by domain, organization\_id, and name. When false (default), only matches by CRM IDs. When true, also matches by domain, organization\_id, and name. Existing accounts are returned without modification in both modes.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Bulk create Apollo contacts
>
> **Slug:** `APOLLO_CREATE_BULK_CONTACTS`
>
> Tool to bulk create multiple contacts in Apollo with a single API call. Use when you need to create multiple contacts efficiently. Supports up to 100 contacts per request with optional deduplication.
>
> #### Input Parameters
>
> **contacts** `array` *required*
>
> Array of contact objects to create. Maximum 100 contacts per request. Each contact should have at least first\_name, last\_name, or email.
>
> **run\_dedupe** `boolean`
>
> Enable full deduplication across all sources. When false (default), creates duplicates for non-email\_import sources and merges with email\_import placeholders only. When true, returns existing contacts without modifying them (except email\_import placeholders which are still merged). Matches by email, CRM IDs, or name + organization.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create call record in Apollo
>
> **Slug:** `APOLLO_CREATE_CALL_RECORD`
>
> Tool to log call records in Apollo from external systems. Use when recording calls made through outside systems like Orum or Nooks; requires a master API key and cannot dial prospects directly.
>
> #### Input Parameters
>
> **note** `string`
>
> Add a note to the call record.
>
> **logged** `boolean`
>
> Set to true if you want to create an individual record for the phone call in Apollo.
>
> **status** `string ("queued" | "ringing" | "in-progress" | "completed" | "no_answer" | "failed" | "busy")`
>
> Possible status values for a phone call.
>
> **user\_id** `array`
>
> Designate the caller in your team's Apollo account. Use the Get a List of Users endpoint to retrieve IDs for all of the users within your Apollo account.
>
> **duration** `integer`
>
> The duration of the call in seconds. Do not enter minutes.
>
> **end\_time** `string`
>
> The time when the call ended. Should adhere to the ISO 8601 date-time format. Apollo uses GMT by default. You can adjust the time manually by specifying in hours and minutes how much you want to offset GMT.
>
> **to\_number** `string`
>
> The phone number that you dialed.
>
> **account\_id** `string`
>
> Associate the call with an account. Use the Search for Accounts endpoint to retrieve IDs for all of the accounts within your Apollo account.
>
> **contact\_id** `string`
>
> Designate the contact that was called. Use the Search for Contacts endpoint to retrieve IDs for all of the contacts within your Apollo account.
>
> **start\_time** `string`
>
> The time when the call started. Should adhere to the ISO 8601 date-time format. Apollo uses GMT by default. You can adjust the time manually by specifying in hours and minutes how much you want to offset GMT.
>
> **from\_number** `string`
>
> The phone number that dialed you.
>
> **phone\_call\_outcome\_id** `string`
>
> Assign a call outcome to the record. Call outcomes are unique to your team's Apollo account. When you use the Disposition search filter for calls in the Apollo product, you can find the corresponding call outcome ID in the URL.
>
> **phone\_call\_purpose\_id** `string`
>
> Assign a call purpose to the record. Call purposes are unique to your team's Apollo account. When you use the Purpose search filter for calls in the Apollo product, you can find the corresponding call purpose ID in the URL.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Apollo contact
>
> **Slug:** `APOLLO_CREATE_CONTACT`
>
> Creates a new contact in Apollo.io; use `account_id` to link to an organization and `contact_stage_id` for sales stage. Apollo does not auto-deduplicate — duplicate records sharing the same email are silently created; always search via APOLLO\_SEARCH\_CONTACTS before calling this tool. Requires explicit user confirmation before execution.
>
> #### Input Parameters
>
> **email** `string`
>
> The primary email address for the contact.
>
> **title** `string`
>
> The contact's current job title.
>
> **last\_name** `string` *required*
>
> Last name of the contact.
>
> **account\_id** `string`
>
> Apollo ID of the organization to assign this contact; obtain via 'Organization Search' (usually the `id` field).
>
> **first\_name** `string` *required*
>
> First name of the contact.
>
> **home\_phone** `string`
>
> Home phone number. Apollo attempts to parse/sanitize format.
>
> **label\_names** `array`
>
> Descriptive labels to categorize the contact; new labels create new lists in Apollo. Validate values against existing Apollo labels via APOLLO\_GET\_LABELS before use; unrecognized or mismatched values can cause request failures.
>
> **other\_phone** `string`
>
> Alternative or unspecified-type phone number. Apollo attempts to parse/sanitize format.
>
> **website\_url** `string`
>
> Full corporate website URL for the contact's employer (e.g., '[https://www.apollo.io/](https://www.apollo.io/)'); must be an official company site, not social media.
>
> **direct\_phone** `string`
>
> Primary direct dial phone number. Apollo attempts to parse/sanitize format.
>
> **mobile\_phone** `string`
>
> Mobile phone number. Apollo attempts to parse/sanitize format.
>
> **corporate\_phone** `string`
>
> Work or office direct line. Apollo attempts to parse/sanitize format.
>
> **contact\_stage\_id** `string`
>
> Apollo ID for the contact's sales/engagement stage (e.g., representing 'Approaching'); obtain via an action listing contact stages.
>
> **organization\_name** `string`
>
> Name of the contact's current organization. Use 'Organization Search' for the exact Apollo-recognized name for best results.
>
> **present\_raw\_address** `string`
>
> Contact's current location as a single string (e.g., 'Atlanta, United States', 'Tokyo, Japan').
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create custom field
>
> **Slug:** `APOLLO_CREATE_CUSTOM_FIELD`
>
> Creates a new custom field in Apollo.io for contacts, accounts, or opportunities. Use when you need to define additional data fields beyond Apollo's standard attributes.
>
> #### Input Parameters
>
> **meta** `object`
>
> Optional metadata for the custom field.
>
> **type** `string ("string" | "textarea" | "number" | "date" | "datetime" | "boolean")` *required*
>
> Type of the custom field that determines what kind of data it can store.
>
> **label** `string` *required*
>
> Name/label for the custom field you want to create in Apollo.
>
> **modality** `string ("contact" | "account" | "opportunity")`
>
> Enum for custom field modality (which object type the field applies to).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Apollo deal
>
> **Slug:** `APOLLO_CREATE_DEAL`
>
> Creates a new sales opportunity (deal) in Apollo.io; all provided IDs (`owner_id`, `account_id`, `opportunity_stage_id`) must be valid existing Apollo identifiers. This action has persistent side effects — obtain explicit user confirmation before invoking.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Human-readable name for the new deal.
>
> **amount** `string`
>
> Monetary value (string of numbers only, e.g., '50000', no symbols/commas). Currency is based on Apollo account settings.
>
> **owner\_id** `string`
>
> Unique identifier of the Apollo user owning this deal. Retrieve via 'Get a List of Users' endpoint.
>
> **account\_id** `string`
>
> Unique identifier of the Apollo account (company) for this deal. Find via 'Organization Search' endpoint.
>
> **closed\_date** `string`
>
> Anticipated deal closing date (YYYY-MM-DD).
>
> **opportunity\_stage\_id** `string`
>
> Unique identifier for the deal's sales pipeline stage (e.g., 'Prospecting'). Retrieve via 'List Deal Stages' endpoint.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Email Draft
>
> **Slug:** `APOLLO_CREATE_EMAIL_DRAFT`
>
> Create an unsent Apollo outreach draft, or return the existing draft already linked to outreach\_task\_id.
>
> #### Input Parameters
>
> **subject** `string`
>
> Subject line for the draft.
>
> **body\_html** `string`
>
> HTML body, which Apollo sanitizes before saving.
>
> **contact\_id** `string`
>
> Apollo ID of the contact receiving the draft. Required unless replying to an existing message.
>
> **recipients** `array`
>
> To, cc, and bcc recipients for the draft.
>
> **attachment\_ids** `array`
>
> Apollo attachment IDs to include with the draft.
>
> **enable\_tracking** `boolean`
>
> Whether to enable permitted open and click tracking.
>
> **outreach\_task\_id** `string`
>
> Apollo outreach task ID to associate with the draft. If that task already has a drafted email, Apollo returns and links the existing draft instead of creating another.
>
> **emailer\_template\_id** `string`
>
> Apollo email template ID to associate with the draft.
>
> **in\_response\_to\_emailer\_message\_id** `string`
>
> Apollo email message ID to reply to; Apollo infers the contact and recipients from it.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Apollo Sequence
>
> **Slug:** `APOLLO_CREATE_SEQUENCE`
>
> Create an Apollo outreach sequence, optionally including steps and email variants.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Human-readable name for the sequence.
>
> **active** `boolean`
>
> Whether to activate the sequence immediately. Inactive sequences do not send steps.
>
> **folder\_id** `string`
>
> Apollo ID of the folder in which to place the sequence.
>
> **label\_names** `array`
>
> List names to apply to the sequence. Apollo creates labels that do not exist.
>
> **emailer\_steps** `array`
>
> Ordered sequence steps and their email variants.
>
> **mark\_paused\_if\_ooo** `boolean`
>
> Whether to pause a contact when Apollo detects an out-of-office reply.
>
> **max\_emails\_per\_day** `integer`
>
> Maximum number of emails the sequence sends per day. Must not be negative.
>
> **emailer\_schedule\_id** `string`
>
> Apollo ID of the non-empty team schedule controlling email send days and times.
>
> **sequence\_ruleset\_id** `string`
>
> Apollo ID of an existing ruleset whose shared settings should apply.
>
> **mark\_finished\_if\_click** `boolean`
>
> Whether to finish a contact in the sequence after an email link click.
>
> **mark\_finished\_if\_reply** `boolean`
>
> Whether to finish a contact in the sequence after an email reply.
>
> **create\_task\_if\_email\_open** `boolean`
>
> Whether to create a task after a contact reaches the email-open threshold.
>
> **sequence\_by\_exact\_daytime** `boolean`
>
> Whether every step uses exact\_datetime instead of relative wait fields.
>
> **excluded\_account\_stage\_ids** `array`
>
> Team account-stage IDs excluded from the sequence.
>
> **excluded\_contact\_stage\_ids** `array`
>
> Team contact-stage IDs excluded from the sequence.
>
> **mark\_finished\_if\_interested** `boolean`
>
> Whether to finish a contact in the sequence when marked interested.
>
> **same\_account\_reply\_delay\_days** `integer`
>
> Days to pause other contacts at the same account after a reply, up to 1000.
>
> **email\_open\_trigger\_task\_threshold** `integer`
>
> Number of email opens that triggers task creation.
>
> **days\_to\_wait\_before\_mark\_as\_response** `integer`
>
> Days after which an incoming email is no longer treated as a sequence response.
>
> **ignore\_apollo\_global\_email\_bounce\_list** `boolean`
>
> Whether to send to contacts on Apollo's global email bounce list.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Apollo Sequence Step
>
> **Slug:** `APOLLO_CREATE_SEQUENCE_STEP`
>
> Create one step at a specified position in an existing Apollo outreach sequence.
>
> #### Input Parameters
>
> **note** `string`
>
> Instructions or context for the new step.
>
> **type** `string ("auto_email" | "manual_email" | "call" | "action_item" | "linkedin_step_connect" | "linkedin_step_message" | "linkedin_step_view_profile" | "linkedin_step_interact_post")` *required*
>
> Sequence step type supported by Apollo.
>
> **position** `integer` *required*
>
> One-based position for the new step in the sequence.
>
> **priority** `string ("high" | "medium" | "low")`
>
> Task priority. Not applicable to auto-email steps.
>
> **wait\_mode** `string ("minute" | "hour" | "day")`
>
> Unit for wait\_time. Provide with wait\_time for relative scheduling; omit for an exact-datetime sequence.
>
> **wait\_time** `integer`
>
> Delay after the preceding step, measured in wait\_mode units. Provide with wait\_mode for relative scheduling; omit for an exact-datetime sequence.
>
> **sequence\_id** `string` *required*
>
> Apollo ID of the existing sequence that receives the step.
>
> **exact\_datetime** `string`
>
> Future ISO 8601 execution time for exact-datetime sequences.
>
> **max\_emails\_per\_day** `integer`
>
> Maximum emails this step may send per day. Must not be negative.
>
> **auto\_skip\_in\_x\_days** `integer`
>
> Days after which an incomplete task step is skipped.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Apollo Task
>
> **Slug:** `APOLLO_CREATE_TASK`
>
> Tool to create a single task in Apollo.io. Use when you need to add a new task to your team's Apollo account for a specific contact. The task will be assigned to a user and includes details like type, status, priority, due date, and optional notes.
>
> #### Input Parameters
>
> **note** `string`
>
> Add a description for the task. This should be a human-readable message. This parameter is not required, but it is recommended as it provides the task owner with more context on the action they need to take.
>
> **type** `string ("call" | "outreach_manual_email" | "linkedin_step_connect" | "linkedin_step_message" | "linkedin_step_view_profile" | "linkedin_step_interact_post" | "action_item")` *required*
>
> Set the task to be one of the following task types. This enables the task owner to know the type of action they need to take: 'call' (Call the contact), 'outreach\_manual\_email' (Email the contact), 'linkedin\_step\_connect' (Send a LinkedIn invitation), 'linkedin\_step\_message' (Send a LinkedIn message), 'linkedin\_step\_view\_profile' (View LinkedIn profile), 'linkedin\_step\_interact\_post' (Interact with LinkedIn posts), 'action\_item' (Generic action - recommended to use with note parameter).
>
> **title** `string`
>
> A title for the task. If omitted, Apollo will display an auto-generated title based on the task type and contact name.
>
> **due\_at** `string` *required*
>
> The full date and time when the task will be due. Your entry should adhere to the ISO 8601 date-time format. Apollo uses Greenwich Mean Time (GMT) by default. If you do not account for time zone differences, you could add a task due date that falls on a different day than you intended. The value you enter can either adhere to GMT, or you can adjust the time manually by specifying in hours and minutes how much you want to offset GMT.
>
> **status** `string ("scheduled" | "completed" | "skipped")` *required*
>
> The status of the task being created. For future-facing tasks, use 'scheduled'. For tasks that are already completed, use 'completed' or 'skipped'.
>
> **user\_id** `string` *required*
>
> The ID for the task owner within your team's Apollo account. This is the user that will take action on the contact. Use the 'Get a List of Users' endpoint to retrieve IDs for all users within your Apollo account.
>
> **priority** `string ("high" | "medium" | "low")`
>
> Valid priority levels for tasks
>
> **contact\_id** `string` *required*
>
> The Apollo ID for the contact that you want to be on the receiving end of the action. To find contact IDs, call the 'Search for Contacts' endpoint and identify the 'id' value for the contact.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Deactivate Sequence
>
> **Slug:** `APOLLO_DEACTIVATE_SEQUENCE`
>
> Deactivate an active Apollo sequence. Deactivation pauses all enrolled contacts and stops scheduled email sends. Reference: [https://docs.apollo.io/reference/abort-sequence](https://docs.apollo.io/reference/abort-sequence)
>
> #### Input Parameters
>
> **sequence\_id** `string` *required*
>
> Apollo ID of the active sequence to deactivate.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Export Conversations
>
> **Slug:** `APOLLO_EXPORT_CONVERSATIONS`
>
> Start an asynchronous gzipped JSON conversation export and email a team member when it is ready. Each exported conversation with AI insights costs 1 credit; conversations without AI insights are free. Free plans allow one export request per minute and 20 per hour.
>
> #### Input Parameters
>
> **email** `string` *required*
>
> Email address of a valid Apollo team member. Apollo emails this person when the asynchronous export is ready.
>
> **end\_time** `string` *required*
>
> End of the export range as an ISO 8601 timestamp in GMT. Must be later than start\_time.
>
> **start\_time** `string` *required*
>
> Start of the export range as an ISO 8601 timestamp in GMT. Must be earlier than end\_time.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Account by ID
>
> **Slug:** `APOLLO_GET_ACCOUNT`
>
> Tool to retrieve detailed information about a specific account by its Apollo ID. Use when you need to fetch complete account data including company details, contact information, and CRM integration fields.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The Apollo ID for the account that you want to retrieve. To find account IDs, call the Search for Accounts endpoint and identify the id value for the account.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Check Apollo API key status
>
> **Slug:** `APOLLO_GET_AUTH_STATUS`
>
> Tool to check whether the provided Apollo API key is valid and accepted by Apollo (health/auth check).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Apollo Contact
>
> **Slug:** `APOLLO_GET_CONTACT`
>
> Retrieves detailed information about a specific contact by its ID. Use this to view contact details including name, email, phone numbers, organization, and custom fields.
>
> #### Input Parameters
>
> **contact\_id** `string` *required*
>
> The Apollo ID for the contact that you want to view. To find contact IDs, call the Search for Contacts action and identify the 'id' value for the contact.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Conversation
>
> **Slug:** `APOLLO_GET_CONVERSATION`
>
> Retrieve full Apollo conversation details, including transcript, participants, recordings, and opportunities. Charged only when AI insights are present; otherwise free.
>
> #### Input Parameters
>
> **conversation\_id** `string` *required*
>
> Apollo conversation ID. A shared conversation can use the id\_shareid format.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Conversation Export
>
> **Slug:** `APOLLO_GET_CONVERSATION_EXPORT`
>
> Retrieve the download redirect URL for a previously started Apollo conversation export.
>
> #### Input Parameters
>
> **export\_id** `string` *required*
>
> The export ID returned by Export Conversations.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Current User Profile
>
> **Slug:** `APOLLO_GET_CURRENT_USER_PROFILE`
>
> Return the authenticated Apollo user's identity and optional credit balances.
>
> #### Input Parameters
>
> **include\_credit\_usage** `boolean`
>
> Whether Apollo should include the user's and team's credit usage and remaining balances. Omit to use Apollo's default.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Apollo deal
>
> **Slug:** `APOLLO_GET_DEAL`
>
> Retrieves information about a specific deal by its ID. Use this when you need to view details of a single deal.
>
> #### Input Parameters
>
> **opportunity\_id** `string` *required*
>
> The ID for the deal you want to view. Each deal in the Apollo database is assigned a unique ID. To find deal IDs, call the List All Deals endpoint and identify the value for 'id' for the desired deal.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Email Activities
>
> **Slug:** `APOLLO_GET_EMAIL_ACTIVITIES`
>
> Retrieves content, open and click activity, and recipient details for one Apollo sequence email. Requires a master API key; OAuth is unsupported.
>
> #### Input Parameters
>
> **email\_id** `string` *required*
>
> The Apollo ID of the sequence email to inspect. Use Search Outreach Emails to find email IDs.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Email Content
>
> **Slug:** `APOLLO_GET_EMAIL_CONTENT`
>
> Retrieve content for up to 10 sent team outreach emails.
>
> #### Input Parameters
>
> **ids** `array` *required*
>
> Apollo IDs of sent team outreach emails to retrieve. Apollo uses only the first 10 IDs and silently ignores any remainder. IDs without eligible sent emails are omitted from the response.
>
> **body\_format** `string ("plain" | "html")`
>
> Format for returned email bodies. Use plain for text without HTML tags or html for the original HTML.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Labels
>
> **Slug:** `APOLLO_GET_LABELS`
>
> Retrieves all labels from Apollo.io, used for organizing contacts and accounts. Call this before APOLLO\_CREATE\_CONTACT or APOLLO\_UPDATE\_ACCOUNT to validate label values against the returned list; mismatched labels cause 400/422 errors.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get opportunity stages
>
> **Slug:** `APOLLO_GET_OPPORTUNITY_STAGES`
>
> Retrieves all configured opportunity (deal) stages from the Apollo.io account.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Organization by ID
>
> **Slug:** `APOLLO_GET_ORGANIZATION`
>
> Retrieves organization information by Apollo ID, including available funding, technology, and employee data. Managed responses exclude account-specific fields.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** Estimated \$0.02 per organization retrieved
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The Apollo ID for the organization that you want to research. To find organization IDs, call the Organization Search endpoint and identify the organization\_id value for the organization.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Organization Job Postings
>
> **Slug:** `APOLLO_GET_ORGANIZATION_JOB_POSTINGS`
>
> Retrieves paginated job postings for a specified organization by its ID, optionally filtering by domain; ensure `organization_id` is a valid identifier.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** Estimated \$0.02 per job-posting result page
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination.
>
> **per\_page** `integer`
>
> Number of job postings per page (max 100) for pagination.
>
> **organization\_id** `string` *required*
>
> The unique identifier for the organization whose job postings are being requested.
>
> **q\_organization\_domains** `string`
>
> Filter job postings by the organization's domain (e.g., 'apollo.io').
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Apollo Task
>
> **Slug:** `APOLLO_GET_TASK`
>
> Retrieves the full details of one Apollo task by ID, including associated records and type-specific data when present.
>
> #### Input Parameters
>
> **task\_id** `string` *required*
>
> The Apollo ID for the task to retrieve. Use Search for Tasks to find task IDs.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get typed custom fields
>
> **Slug:** `APOLLO_GET_TYPED_CUSTOM_FIELDS`
>
> Retrieves all typed custom field definitions available in the Apollo.io instance, detailing their types and configurations. Call before constructing payloads for APOLLO\_UPDATE\_CONTACT or APOLLO\_UPDATE\_ACCOUNT — mismatched types or invalid enum options cause 400 errors.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Apollo User
>
> **Slug:** `APOLLO_GET_USER`
>
> Retrieve one teammate in the connected Apollo workspace by Apollo user ID.
>
> #### Input Parameters
>
> **user\_id** `string` *required*
>
> Apollo user ID to retrieve. Use List Apollo Users to find user IDs.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Apollo account stages
>
> **Slug:** `APOLLO_LIST_ACCOUNT_STAGES`
>
> Retrieves the IDs for all available account stages in your team's Apollo account.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List apollo contact stages
>
> **Slug:** `APOLLO_LIST_CONTACT_STAGES`
>
> Retrieves all available contact stages from an Apollo account, including their unique IDs and names.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Apollo deals
>
> **Slug:** `APOLLO_LIST_DEALS`
>
> Retrieves a list of deals from Apollo, using Apollo's default sort order if 'sort\_by\_field' is omitted.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for paginated results.
>
> **per\_page** `integer`
>
> Number of deals to retrieve per page.
>
> **sort\_by\_field** `string`
>
> Field to sort deals by. If not provided, a default sort order is applied by the Apollo API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List email accounts
>
> **Slug:** `APOLLO_LIST_EMAIL_ACCOUNTS`
>
> Retrieves all email accounts and their details for the authenticated user; takes no parameters.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Fields
>
> **Slug:** `APOLLO_LIST_FIELDS`
>
> Retrieves all field definitions from Apollo.io, including system fields and custom fields. Use the optional 'source' parameter to filter by field type (system, custom, or crm\_synced).
>
> #### Input Parameters
>
> **source** `string ("system" | "custom" | "crm_synced")`
>
> Source type of the field.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Apollo Notes
>
> **Slug:** `APOLLO_LIST_NOTES`
>
> List notes associated with Apollo records. Supply at least one contact, account, opportunity, calendar-event, or conversation ID field.
>
> #### Input Parameters
>
> **skip** `integer`
>
> Number of matching notes to skip. Apollo defaults to 0.
>
> **limit** `integer`
>
> Maximum number of notes to return, from 1 to 100. Apollo defaults to 25.
>
> **account\_id** `string`
>
> ID of an account whose notes to retrieve.
>
> **contact\_id** `string`
>
> ID of a contact whose notes to retrieve.
>
> **start\_date** `string`
>
> Return notes created on or after this date, in YYYY-MM-DD format.
>
> **contact\_ids** `array`
>
> IDs of contacts whose notes to retrieve.
>
> **sort\_by\_field** `string ("created_at" | "updated_at")`
>
> Field by which to sort notes. Apollo defaults to created\_at.
>
> **opportunity\_id** `string`
>
> ID of an opportunity whose notes to retrieve.
>
> **sort\_direction** `string ("asc" | "desc")`
>
> Direction in which to sort notes. Apollo defaults to desc.
>
> **conversation\_id** `string`
>
> ID of a conversation whose notes to retrieve.
>
> **conversation\_ids** `array`
>
> IDs of conversations whose notes to retrieve.
>
> **calendar\_event\_id** `string`
>
> ID of a calendar event whose notes to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Apollo Users
>
> **Slug:** `APOLLO_LIST_USERS`
>
> Retrieves a list of all users (teammates) associated with the Apollo account, supporting pagination via `page` and `per_page` parameters. Use this to obtain numeric user IDs required by operations like APOLLO\_UPDATE\_CONTACT\_OWNERSHIP — names or email addresses are not accepted in place of these IDs.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination (e.g., 1, 2, 3...). Defaults to the first page if omitted.
>
> **per\_page** `integer`
>
> Number of users to retrieve per page (e.g., 10, 25, 50...). Defaults to a predefined page size if omitted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Enrich organization data
>
> **Slug:** `APOLLO_ORGANIZATION_ENRICHMENT`
>
> Fetches comprehensive organization enrichment data from Apollo.io for a given company domain; results are most meaningful if the company exists in Apollo's database. Charged on every call; may be unavailable on free plans. Returns HTTP 429 under burst usage; use exponential backoff on retries.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** Estimated \$0.02 per organization enriched
>
> #### Input Parameters
>
> **domain** `string` *required*
>
> The domain of the company to enrich, (e.g., 'apollo.io', 'microsoft.com'). Do not include '[www](http://www).' or '@' symbols.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search organizations in Apollo
>
> **Slug:** `APOLLO_ORGANIZATION_SEARCH`
>
> Search Apollo's organization database using filters and paginated results. Calls are charged and may be unavailable on free plans; restrictive filters can yield no matches.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** Estimated \$0.02 per organization search page
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for paginated results, used with `per_page`. Use `total_pages` from the response to iterate; a single call returns at most 100 records.
>
> **per\_page** `integer`
>
> Number of organization records per page, used with `page`.
>
> **organization\_ids** `array`
>
> Apollo's unique organization IDs to fetch specific companies.
>
> **q\_organization\_name** `string`
>
> Organization name; supports partial matching (e.g., 'Apollo' matches 'Apollo Inc.').
>
> **organization\_locations** `array`
>
> Company HQs (city, state, country) to include; filters on primary HQ only.
>
> **organization\_not\_locations** `array`
>
> Company HQs (city, state, country) to exclude; useful for territory management.
>
> **q\_organization\_domains\_list** `array`
>
> Company domains to filter by (e.g., 'apollo.io', 'google.com'); exclude '[www](http://www).' or '@' prefixes. Normalize domain casing to improve match quality.
>
> **q\_organization\_keyword\_tags** `array`
>
> Keywords for company industries/specializations (e.g., 'software', 'healthcare').
>
> **organization\_num\_employees\_ranges** `array`
>
> Employee count ranges. Each string must be in 'min,max' format (e.g., '1,10').
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Enrich person with Apollo
>
> **Slug:** `APOLLO_PEOPLE_ENRICHMENT`
>
> Enriches a person using an Apollo ID, email, hashed email, LinkedIn URL, or first and last name with organization name or domain. Phone reveal requires a webhook; managed calls support base enrichment only, without personal email or phone reveal or webhook delivery.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.02–\$0.18 per person enriched; waterfall may cost more.
>
> #### Input Parameters
>
> **id** `string`
>
> The Apollo ID for the person. Each person in the Apollo database is assigned a unique ID. To find IDs, call the People API Search endpoint and identify the values for person\_id.
>
> **name** `string`
>
> Full name of the person; used for matching instead of or with `first_name` and `last_name`.
>
> **email** `string`
>
> The email address of the person.
>
> **domain** `string`
>
> Domain name of the person's organization (e.g., 'apollo.io'). Must be a bare hostname without protocol (http/https) or markup. Exclude '[www](http://www).' prefix.
>
> **last\_name** `string`
>
> The last name of the person.
>
> **first\_name** `string`
>
> The first name of the person.
>
> **webhook\_url** `string`
>
> Publicly accessible URL for Apollo to POST phone number data if `reveal_phone_number` is true. Phone data is delivered asynchronously via POST to this URL and is NOT returned inline in the API response.
>
> **hashed\_email** `string`
>
> MD5 or SHA-256 hashed email; used for matching if plain email is unavailable.
>
> **linkedin\_url** `string`
>
> Full URL of the person's LinkedIn profile.
>
> **organization\_name** `string`
>
> Name of the person's organization; used with name fields for matching.
>
> **reveal\_phone\_number** `boolean`
>
> If true, attempts to enrich with phone numbers; increases the price and requires `webhook_url`.
>
> **reveal\_personal\_emails** `boolean`
>
> If true, attempts to enrich with personal emails; increases the price.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Apollo people search
>
> **Slug:** `APOLLO_PEOPLE_SEARCH`
>
> Searches Apollo's database for net-new prospects using filters, returning preview records with a display limit of 50,000. The search does not return email addresses or phone numbers; restrictive filter combinations can return no results.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0 per request
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number (1-based) for pagination. Max 500 if `per_page` is 100. Iterate until `pagination.total_pages` is reached to avoid missing contacts.
>
> **per\_page** `integer`
>
> Records per page. Max 100.
>
> **q\_keywords** `string`
>
> Search keywords for profile fields (names, skills, job descriptions, technologies). Use organizational filters (q\_organization\_domains, person\_titles) as primary search criteria, then optionally add a first name here for refinement. Avoid full names (last names are often obfuscated in results). Do not combine names with skill keywords as this creates an AND search that may return no results.
>
> **person\_titles** `array`
>
> Job titles (e.g., 'software engineer'); matches if any title found, may include similar. Can be a list of titles or a comma-separated string. Each list entry must be a plain string — do not embed boolean operators (e.g., 'title1 OR title2') in a single string, as this returns zero results.
>
> **organization\_ids** `array`
>
> Apollo-specific company IDs to find people within these organizations; obtain from Organization Search. Can be a list or comma-separated string.
>
> **person\_locations** `array`
>
> Current geographic locations of people (e.g., 'London', 'California', 'Germany'). Can be a list or comma-separated string.
>
> **person\_seniorities** `array`
>
> Job seniority levels for current positions (e.g., 'Director', 'VP', 'Senior'). Can be a list or comma-separated string.
>
> **contact\_email\_status** `array`
>
> Email statuses to filter contacts. Allowed: 'verified', 'unverified', 'likely to engage', 'unavailable'. Can be a list or comma-separated string.
>
> **organization\_locations** `array`
>
> Company HQs (e.g., 'Texas', 'Tokyo', 'Spain'); uses primary HQ location. Can be a list or comma-separated string.
>
> **q\_organization\_domains** `array`
>
> Company domains (e.g., 'apollo.io', 'microsoft.com'); exclude '[www](http://www).' or '@' prefixes. Can be a list or comma-separated string.
>
> **organization\_num\_employees\_ranges** `array`
>
> Org employee count ranges for organizations (e.g., '1,10', '10000,20000'); format as 'min,max' string. Can be a list or semicolon-separated string (e.g., '1,10;250,500').
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Query Analytics Report
>
> **Slug:** `APOLLO_QUERY_ANALYTICS_REPORT`
>
> Query Apollo analytics metrics, dimensions, filters, and date ranges. This operation is free. Apollo rate limits depend on the connected team's plan; use the returned rate\_limit metadata as the source of truth. Metric and dimension descriptions include common Apollo identifiers; team-defined custom metrics use custom\_metric\_\{id}.
>
> #### Input Parameters
>
> **sorts** `array` *required*
>
> Zero or one metric sort. Apollo applies only the first sort.
>
> **filters** `object` *required*
>
> Known filters plus additional dimension filters accepted by Apollo.
>
> **metrics** `array` *required*
>
> Metrics to query. An empty list returns no metric columns.
>
> **group\_by** `array` *required*
>
> Zero or one row dimension; use an empty list for flat totals.
>
> **date\_ranges** `array` *required*
>
> Zero or one preset date window for the query.
>
> **pivot\_group\_by** `array`
>
> Optional zero or one column dimension for a pivot cross-tab.
>
> **skip\_group\_by\_values** `array`
>
> Raw group keys to exclude, up to 500 values.
>
> **min\_ratio\_denominator** `integer`
>
> Exclude ratio calculations whose denominator is below this threshold.
>
> **group\_by\_totals\_selected** `boolean` *required*
>
> Include an aggregated totals row for the group dimension.
>
> **pivot\_group\_by\_totals\_selected** `boolean` *required*
>
> Include an aggregated totals column for the pivot dimension.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Apollo Accounts
>
> **Slug:** `APOLLO_SEARCH_ACCOUNTS`
>
> Searches for accounts within your existing Apollo.io database using various criteria; requires a paid plan and is limited to 50,000 records.
>
> #### Input Parameters
>
> **page** `integer`
>
> The page number for pagination, starting from 1. This is used with the 'per\_page' parameter to navigate through results.
>
> **per\_page** `integer`
>
> The number of results to return per page. This is used for pagination in conjunction with the 'page' parameter. Maximum value is 100.
>
> **sort\_by\_field** `string`
>
> The field by which to sort the accounts. Valid options are: 'account\_last\_activity\_date', 'account\_created\_at', 'account\_updated\_at'.
>
> **sort\_ascending** `boolean`
>
> Determines the sort order. Set to true for ascending order. This parameter must be used in conjunction with 'sort\_by\_field'.
>
> **account\_stage\_ids** `array`
>
> A list of Apollo IDs for account stages to filter the results by. These IDs can be retrieved using the 'List Account Stages' endpoint.
>
> **q\_organization\_name** `string`
>
> Keywords to search for in account names. This field supports partial name matching.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search for Calls
>
> **Slug:** `APOLLO_SEARCH_CALLS`
>
> Searches for call records in Apollo.io using filters like date range, duration, direction (inbound/outgoing), users, contacts, purposes, outcomes, and keywords. Supports pagination for efficient data retrieval.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination. Use with per\_page to make search results navigable and improve performance.
>
> **inbound** `string`
>
> Filter calls by direction: 'incoming' (prospect called your team) or 'outgoing' (your team called the prospect).
>
> **per\_page** `integer`
>
> Number of search results per page. Limiting results per page improves performance. Use page parameter to navigate pages.
>
> **user\_ids** `array`
>
> Find calls that included specific users in your team's Apollo account. Use the Get a List of Users endpoint to retrieve user IDs.
>
> **q\_keywords** `string`
>
> Keywords to narrow the search of calls in your team's Apollo account.
>
> **duration\_max** `integer`
>
> Upper bound for call duration in seconds. Use with duration\_min. This number should be larger than duration\_min.
>
> **duration\_min** `integer`
>
> Lower bound for call duration in seconds. Use with duration\_max. This number should be smaller than duration\_max.
>
> **date\_range\_max** `string`
>
> Upper bound of date range to search (format: YYYY-MM-DD). Use with date\_range\_min. This date should fall after date\_range\_min.
>
> **date\_range\_min** `string`
>
> Lower bound of date range to search (format: YYYY-MM-DD). Use with date\_range\_max. This date should fall before date\_range\_max.
>
> **contact\_label\_ids** `array`
>
> Find calls that included specific contacts. Contacts are people explicitly added to your database.
>
> **phone\_call\_outcome\_ids** `array`
>
> Filter calls based on their outcome. Call outcomes are unique to your team's Apollo account. Find the outcome ID in the URL when using the Disposition filter in Apollo product.
>
> **phone\_call\_purpose\_ids** `array`
>
> Filter calls based on their purpose. Call purposes are unique to your team's Apollo account. Find the purpose ID in the URL when using the Purpose filter in Apollo product.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Apollo contacts
>
> **Slug:** `APOLLO_SEARCH_CONTACTS`
>
> Searches Apollo contacts using keywords, stage IDs (from 'List Contact Stages' action), or sorting (max 50,000 records; `sort_ascending` requires `sort_by_field`). Search before creating contacts to avoid duplicates.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number of results (1-indexed, max 500); use with 'per\_page' for pagination. Check `pagination.total_pages` in the response to determine when to stop iterating.
>
> **per\_page** `integer`
>
> Contact records to return per page (max 100); for pagination.
>
> **q\_keywords** `string`
>
> Keywords for matching contact names, titles, employers, or emails.
>
> **sort\_by\_field** `string`
>
> Field to sort results. Valid options: 'contact\_last\_activity\_date', 'contact\_email\_last\_opened\_at', 'contact\_email\_last\_clicked\_at', 'contact\_created\_at', 'contact\_updated\_at'.
>
> **sort\_ascending** `boolean`
>
> Sorts results in ascending order; requires 'sort\_by\_field'.
>
> **contact\_stage\_ids** `array`
>
> Apollo contact stage IDs to filter contacts; obtain IDs using the 'List Contact Stages' action.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Apollo Conversations
>
> **Slug:** `APOLLO_SEARCH_CONVERSATIONS`
>
> Search Apollo video meetings and dialer calls using record, participant, date, scorecard, sorting, and visibility filters.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination, starting at 1.
>
> **limit** `integer`
>
> Maximum number of conversation results to request.
>
> **tag\_ids** `array`
>
> Apollo label or tag IDs applied to the conversations.
>
> **account\_id** `string`
>
> Apollo account ID associated with the conversations.
>
> **date\_range** `object`
>
> Time window used to filter conversations.
>
> **contact\_ids** `array`
>
> Apollo contact IDs associated with the conversations.
>
> **tracker\_ids** `array`
>
> Apollo tracker IDs associated with the conversations.
>
> **sort\_by\_field** `string`
>
> Conversation field by which Apollo should sort results.
>
> **organization\_ids** `array`
>
> Apollo organization IDs associated with the conversations.
>
> **conversation\_type** `string ("video_conference" | "phone_call")`
>
> Restrict results to video conferences or Apollo dialer calls.
>
> **scorecard\_max\_rating** `number`
>
> Maximum scorecard rating included in the results.
>
> **scorecard\_template\_id** `string`
>
> Apollo scorecard template ID used to filter conversations.
>
> **enforce\_contact\_boundary** `boolean`
>
> Whether to restrict results to conversations visible to the specified contacts.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search news articles
>
> **Slug:** `APOLLO_SEARCH_NEWS_ARTICLES`
>
> Tool to search for news articles about companies in Apollo's database. Use when you need to find recent news, announcements, or updates about specific organizations using their Apollo IDs.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** Estimated \$0.02 per news-result page
>
> #### Input Parameters
>
> **page** `integer`
>
> The page number of the Apollo data that you want to retrieve. Use this parameter in combination with the per\_page parameter to make search results for navigable and improve the performance of the endpoint. Example: 4
>
> **per\_page** `integer`
>
> The number of search results that should be returned for each page. Limiting the number of results per page improves the endpoint's performance. Use the page parameter to search the different pages of data. Example: 10
>
> **categories** `array`
>
> Filter your search to include only certain categories or sub-categories of news. Use the News search filter for companies within Apollo to uncover all possible categories and sub-categories. Examples: hires, investment, contract
>
> **organization\_ids** `array` *required*
>
> The Apollo IDs for the companies you want to include in your search results. Each company in the Apollo database is assigned a unique ID. To find IDs, call the Organization Search endpoint and identify the values for organization\_id. Example: 5e66b6381e05b4008c8331b8
>
> **published\_at\_max** `string`
>
> Set the upper bound of the date range you want to search. Use this parameter in combination with the published\_at\_min parameter. This date should fall after the published\_at\_min date. The date should be formatted as YYYY-MM-DD. Example: 2025-05-15
>
> **published\_at\_min** `string`
>
> Set the lower bound of the date range you want to search. Use this parameter in combination with the published\_at\_max parameter. This date should fall before the published\_at\_max date. The date should be formatted as YYYY-MM-DD. Example: 2025-02-15
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search outreach emails
>
> **Slug:** `APOLLO_SEARCH_OUTREACH_EMAILS`
>
> Tool to search for outreach emails sent through Apollo sequences. Use when you need to find emails created and sent by your team as part of Apollo email campaigns. This endpoint requires a master API key and has a display limit of 50,000 records (100 records per page, up to 500 pages).
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination (1-based). Maximum page number is 500.
>
> **per\_page** `integer`
>
> Number of email records per page. Maximum value is 100.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search sequences
>
> **Slug:** `APOLLO_SEARCH_SEQUENCES`
>
> Search Apollo sequences, such as automated email campaigns, optionally filtering by full or partial name. Results are paginated, with a configurable page and page size.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for paginated results.
>
> **q\_name** `string`
>
> Name or part of the name of the sequence to search for. If omitted, results are not filtered by name.
>
> **per\_page** `integer`
>
> Number of sequences per page. Maximum value is 100.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search tasks
>
> **Slug:** `APOLLO_SEARCH_TASKS`
>
> Searches for tasks in Apollo.io using filters like keywords, date ranges (due, created, updated), priorities, types, assigned users, associated contacts/accounts, supporting sorting and pagination.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination (starts from 1).
>
> **per\_page** `integer`
>
> Number of tasks per page (1-100).
>
> **q\_keywords** `string`
>
> Keywords for searching task notes or subjects (matches partial words).
>
> **task\_types** `array`
>
> List of task types to filter by (e.g., 'call', 'email').
>
> **account\_ids** `array`
>
> List of account IDs to filter tasks by association.
>
> **contact\_ids** `array`
>
> List of contact IDs to filter tasks by association.
>
> **sort\_by\_field** `string`
>
> Field for sorting tasks. Note: This parameter may not be supported by the API and could result in 'Invalid sort criteria' error.
>
> **task\_user\_ids** `array`
>
> List of user IDs to filter tasks by assignment.
>
> **due\_date\_range** `object`
>
> Filter tasks by due date range.
>
> **sort\_ascending** `boolean`
>
> Sort order: `true` for ascending, `false` for descending.
>
> **task\_priorities** `array`
>
> List of lowercase task priorities to filter by. Valid values are 'high', 'medium', 'low'.
>
> **task\_created\_at\_range** `object`
>
> Filter tasks by creation date range.
>
> **task\_updated\_at\_range** `object`
>
> Filter tasks by last update date range.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Send Email Now
>
> **Slug:** `APOLLO_SEND_EMAIL_NOW`
>
> Queue an Apollo email for external sending; success means queued, not delivered. This action causes Apollo to send an email outside Composio. Apollo processes the send asynchronously, so callers must check send status separately for delivery. Reference: [https://docs.apollo.io/reference/send-email-now](https://docs.apollo.io/reference/send-email-now)
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Apollo ID of the drafted, scheduled, or failed email message to queue for immediate sending.
>
> **surface** `string`
>
> Apollo surface that initiated the send, used by Apollo for attribution and analytics.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update an Apollo account
>
> **Slug:** `APOLLO_UPDATE_ACCOUNT`
>
> Updates specified attributes of an existing account in Apollo.io.
>
> #### Input Parameters
>
> **name** `string`
>
> The new name for the account. This should be a human-readable name representing the organization.
>
> **phone** `string`
>
> The new primary phone number for the account. Apollo will attempt to sanitize and standardize the provided phone number format.
>
> **domain** `string`
>
> The new primary domain for the account. Ensure the '[www](http://www).' prefix is excluded (e.g., 'apollo.io' instead of '[www.apollo.io](http://www.apollo.io)').
>
> **owner\_id** `string`
>
> The unique identifier (ID) of the Apollo user to be assigned as the new owner of this account. This ID can be retrieved using the 'Get a List of Users' endpoint.
>
> **account\_id** `string` *required*
>
> The unique Apollo identifier (ID) for the account to be updated. This ID can be retrieved using the 'Search for Accounts' endpoint.
>
> **raw\_address** `string`
>
> The new corporate street address for the account. This can be a free-form string including details like street, city, state, and country.
>
> **account\_stage\_id** `string`
>
> The unique Apollo identifier (ID) for the new account stage (e.g., 'Prospecting', 'Negotiation'). This ID can be retrieved using the 'List Account Stages' endpoint.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update account ownership
>
> **Slug:** `APOLLO_UPDATE_ACCOUNT_OWNERS`
>
> Updates the ownership of multiple Apollo accounts to a specified user. Use when bulk assigning account ownership to a team member.
>
> #### Input Parameters
>
> **owner\_id** `string` *required*
>
> The Apollo user ID to assign as the new owner for all specified accounts. This user must be part of your team's Apollo account. Use the Get a List of Users endpoint to retrieve user IDs.
>
> **account\_ids** `array` *required*
>
> List of Apollo account IDs to update. Each ID uniquely identifies an account in your team's Apollo instance. To find account IDs, use the Search for Accounts endpoint.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Apollo call record
>
> **Slug:** `APOLLO_UPDATE_CALL_RECORD`
>
> Tool to update an existing call record in Apollo.io. Use when you need to modify details of a previously logged phone call such as duration, status, notes, or associated contact/account information.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The Apollo ID for the call record to be updated. To find call record IDs, use the 'Search for Calls' action and identify the 'id' value for the call record.
>
> **note** `string`
>
> Add a note to the call record.
>
> **logged** `boolean`
>
> Set to true if you want to create an individual record for the phone call in Apollo.
>
> **status** `string ("queued" | "ringing" | "in-progress" | "completed" | "no_answer" | "failed" | "busy")`
>
> Enumeration of possible call status values.
>
> **user\_id** `array`
>
> Designate the caller(s) in your team's Apollo account. Use the 'Get a List of Users' action to retrieve IDs for all users within your Apollo account.
>
> **duration** `integer`
>
> The duration of the call in seconds (not minutes).
>
> **end\_time** `string`
>
> The time when the call ended. Should adhere to ISO 8601 date-time format. Apollo uses GMT by default. You can adjust for timezone by specifying offset in hours and minutes.
>
> **to\_number** `string`
>
> The phone number that you dialed.
>
> **account\_id** `string`
>
> Associate the call with an account. Use the 'Search for Accounts' action to retrieve IDs for accounts within your Apollo account.
>
> **contact\_id** `string`
>
> Designate the contact that was called. Use the 'Search for Contacts' action to retrieve IDs for contacts within your Apollo account.
>
> **start\_time** `string`
>
> The time when the call started. Should adhere to ISO 8601 date-time format. Apollo uses GMT by default. You can adjust for timezone by specifying offset in hours and minutes.
>
> **from\_number** `string`
>
> The phone number that dialed you.
>
> **phone\_call\_outcome\_id** `string`
>
> Assign a call outcome to the record. Call outcomes are unique to your team's Apollo account. When you use the Disposition search filter for calls in Apollo, you can find the corresponding call outcome ID in the URL.
>
> **phone\_call\_purpose\_id** `string`
>
> Assign a call purpose to the record. Call purposes are unique to your team's Apollo account. When you use the Purpose search filter for calls in Apollo, you can find the corresponding call purpose ID in the URL.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Apollo contact details
>
> **Slug:** `APOLLO_UPDATE_CONTACT`
>
> Tool to update an existing contact's information in Apollo. Use when you need to modify contact details such as name, email, phone, title, organization, or custom fields. At least one field beyond contact\_id must be provided.
>
> #### Input Parameters
>
> **email** `string`
>
> Update the contact email address.
>
> **title** `string`
>
> Update the job title.
>
> **last\_name** `string`
>
> Update the contact's last name.
>
> **account\_id** `string`
>
> Update the account ID. This associates the contact with a different account.
>
> **contact\_id** `string` *required*
>
> The Apollo ID for the contact that you want to update. To find contact IDs, call the 'Search for Contacts' action and identify the `id` value for the contact.
>
> **first\_name** `string`
>
> Update the contact's first name.
>
> **home\_phone** `string`
>
> Home phone number for the contact.
>
> **label\_names** `array`
>
> Replace lists this contact belongs to. Passing new values will overwrite existing lists.
>
> **other\_phone** `string`
>
> Alternate phone number for the contact.
>
> **website\_url** `string`
>
> Update the employer website URL.
>
> **direct\_phone** `string`
>
> Primary direct phone number for the contact.
>
> **mobile\_phone** `string`
>
> Mobile phone number for the contact.
>
> **corporate\_phone** `string`
>
> Work/office phone number for the contact.
>
> **contact\_stage\_id** `string`
>
> Update the contact stage ID. Use the 'List Contact Stages' action to get valid stage IDs.
>
> **organization\_name** `string`
>
> Update the employer (company) name.
>
> **present\_raw\_address** `string`
>
> Update location (city/state/country) as a single string.
>
> **typed\_custom\_fields** `object`
>
> Add information to custom fields in Apollo. Your custom fields are unique to your team's Apollo account. To utilize this parameter successfully, call the 'Get a List of All Custom Fields' action and identify the `id` value for the custom field, as well as the appropriate data type. For string fields, pass a string value. For picklist fields (single-select), pass a string with the picklist option ID. For multi-select picklist fields, pass a list of picklist option IDs.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update contact ownership
>
> **Slug:** `APOLLO_UPDATE_CONTACT_OWNERSHIP`
>
> Updates the ownership of specified Apollo contacts to a given Apollo user, who must be part of the same team.
>
> #### Input Parameters
>
> **owner\_id** `string` *required*
>
> Unique Apollo identifier for the user, part of your team's Apollo account, to become the new owner. Must be retrieved from APOLLO\_LIST\_USERS; names and emails are not accepted. An invalid or mismatched ID may cause a silent no-op with no explicit error returned.
>
> **contact\_ids** `array` *required*
>
> Unique Apollo identifiers for existing contacts to update.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Bulk update Apollo contacts
>
> **Slug:** `APOLLO_UPDATE_CONTACTS_BULK`
>
> Tool to bulk update multiple Apollo contacts with a single API call. Use when updating multiple contacts simultaneously - either apply the same updates to all contacts using contact\_ids, or apply different updates to each contact using contact\_attributes. Automatically processes asynchronously for more than 100 contacts.
>
> #### Input Parameters
>
> **async** `boolean`
>
> Force asynchronous processing. Automatically enabled for more than 100 contacts. When true, returns a job object instead of contact data.
>
> **email** `string`
>
> When using contact\_ids, apply this email to all contacts in the list.
>
> **title** `string`
>
> When using contact\_ids, apply this title to all contacts in the list.
>
> **owner\_id** `string`
>
> When using contact\_ids, apply this owner ID to all contacts in the list.
>
> **last\_name** `string`
>
> When using contact\_ids, apply this last name to all contacts in the list.
>
> **account\_id** `string`
>
> When using contact\_ids, apply this account ID to all contacts in the list.
>
> **first\_name** `string`
>
> When using contact\_ids, apply this first name to all contacts in the list.
>
> **contact\_ids** `array`
>
> Array of contact IDs to update with the same values. Use this approach when applying identical updates to multiple contacts. Must provide either contact\_ids or contact\_attributes.
>
> **linkedin\_url** `string`
>
> When using contact\_ids, apply this LinkedIn URL to all contacts in the list.
>
> **organization\_name** `string`
>
> When using contact\_ids, apply this organization name to all contacts in the list.
>
> **contact\_attributes** `array`
>
> Array of contact objects with individual updates. Use this approach when applying different updates to each contact. Must provide either contact\_ids or contact\_attributes.
>
> **visible\_entity\_ids** `array`
>
> Specific contact IDs to return in the response for performance optimization. Only these contacts will be included in the response.
>
> **present\_raw\_address** `string`
>
> When using contact\_ids, apply this address to all contacts in the list.
>
> **typed\_custom\_fields** `object`
>
> When using contact\_ids, apply these custom fields to all contacts in the list as key-value pairs.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update contact stage
>
> **Slug:** `APOLLO_UPDATE_CONTACT_STAGE`
>
> Updates the stage for one or more existing contacts in Apollo.io to a new valid contact stage, useful for managing sales funnel progression.
>
> #### Input Parameters
>
> **contact\_ids** `array` *required*
>
> Unique identifiers for the contacts whose stage needs to be updated.
>
> **contact\_stage\_id** `string` *required*
>
> Unique identifier of the contact stage to assign to the contacts.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update contact status in sequence
>
> **Slug:** `APOLLO_UPDATE_CONTACT_STATUS_IN_SEQUENCE`
>
> Pauses or marks a contact as finished in a designated Apollo sequence. Active status is not supported; the finished, bounced, and unsubscribed selections all request the same mark-as-finished operation.
>
> #### Input Parameters
>
> **status** `string ("active" | "paused" | "finished_replied" | "finished_not_replied" | "bounced" | "unsubscribed")` *required*
>
> New status for the contact in the sequence. Note: 'active' status is not supported by this action.
>
> **contact\_id** `string` *required*
>
> Unique identifier of the contact.
>
> **sequence\_id** `string` *required*
>
> Unique identifier of the sequence.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Apollo deal
>
> **Slug:** `APOLLO_UPDATE_DEALS`
>
> Updates specified fields of an existing Apollo.io deal (opportunity), requiring a valid `opportunity_id`.
>
> #### Input Parameters
>
> **name** `string`
>
> The new human-readable name for the deal. Preserves current name if omitted.
>
> **amount** `string`
>
> The new monetary value of the deal (e.g., '50000'). Preserves current amount if omitted.
>
> **is\_won** `boolean`
>
> Indicates if the deal is won. `true` for won, `false` for lost/open. Preserves current status if omitted.
>
> **source** `string`
>
> The new source from which this deal originated (e.g., 'Website', 'Referral'). Preserves current source if omitted.
>
> **owner\_id** `string`
>
> The unique identifier of the Apollo user to be assigned as the new owner. Obtain this ID via 'List All Users'. Preserves current owner if omitted.
>
> **is\_closed** `boolean`
>
> Indicates if the deal is closed. `true` for closed, `false` for open. Preserves current status if omitted.
>
> **account\_id** `string`
>
> The unique Apollo identifier of the account to be associated. Obtain this ID from account-related actions. Preserves current account if omitted.
>
> **closed\_date** `string`
>
> The new estimated or actual close date (YYYY-MM-DD). Preserves current close date if omitted.
>
> **opportunity\_id** `string` *required*
>
> The unique identifier of the Apollo opportunity (deal) to be updated.
>
> **opportunity\_stage\_id** `string`
>
> The unique identifier for the new stage. Obtain this ID via 'List Deal Stages'. Preserves current stage if omitted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Apollo List
>
> **Slug:** `APOLLO_UPDATE_LABEL`
>
> Rename an Apollo list and optionally change its Book of Business status. Reference: [https://docs.apollo.io/reference/update-a-list](https://docs.apollo.io/reference/update-a-list)
>
> #### Input Parameters
>
> **name** `string` *required*
>
> New list name, unique within its modality.
>
> **label\_id** `string` *required*
>
> Apollo ID of the list to update. Use Get Labels to find it.
>
> **book\_of\_business** `boolean`
>
> Whether an account list is a Book of Business list.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Sequence
>
> **Slug:** `APOLLO_UPDATE_SEQUENCE`
>
> Update an Apollo sequence's settings, ownership, sharing, steps, and touches. Supplying emailer\_steps replaces the ordered step set and can create, update, reorder, or remove steps and their touches based on the IDs supplied. Apollo can require the current complete step list even for a settings-only update. Reference: [https://docs.apollo.io/reference/update-sequence](https://docs.apollo.io/reference/update-sequence)
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Apollo ID of the sequence to update.
>
> **name** `string`
>
> New sequence name.
>
> **user\_id** `string`
>
> Apollo user ID of the sequence's new owner.
>
> **cc\_emails** `string`
>
> Comma-separated email addresses to CC on sequence emails.
>
> **bcc\_emails** `string`
>
> Comma-separated email addresses to BCC on sequence emails.
>
> **label\_names** `array`
>
> Replacement list of labels or folders for the sequence.
>
> **creation\_type** `string ("draft" | "new" | "ai_assistant")`
>
> Sequence creation type.
>
> **emailer\_steps** `array`
>
> Complete ordered step list. Entries with IDs update or reorder existing steps, entries without IDs create steps, and existing steps omitted from this list are removed. Apollo can reject other updates with 'At least one step is required' unless the current complete step list is included.
>
> **max\_emails\_per\_day** `integer`
>
> Maximum number of emails this sequence can send per day.
>
> **sharing\_permission** `object`
>
> Visibility and user or team sharing changes. Sharing access changes may require plan support.
>
> **emailer\_schedule\_id** `string`
>
> Apollo ID of a non-empty team sending schedule to attach.
>
> **same\_account\_reply\_delay\_days** `integer`
>
> Days to wait before contacting another person at the same account.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Apollo Task
>
> **Slug:** `APOLLO_UPDATE_TASK`
>
> Update editable details of an existing Apollo task. Supply at least one update field in addition to task\_id.
>
> #### Input Parameters
>
> **note** `string`
>
> Human-readable task description. This can also be changed on completed or skipped tasks.
>
> **type** `string ("call" | "outreach_manual_email" | "linkedin_step_connect" | "linkedin_step_message" | "linkedin_step_view_profile" | "linkedin_step_interact_post" | "action_item")`
>
> Task type. Only applies to scheduled tasks.
>
> **title** `string`
>
> Task title. Only applies to scheduled tasks.
>
> **due\_at** `string`
>
> Due date and time in ISO 8601 format. Only applies to scheduled tasks.
>
> **status** `string`
>
> Task status. Only applies to scheduled tasks; use Complete Task or Skip Task instead of setting a task done here.
>
> **task\_id** `string` *required*
>
> The Apollo ID of the task to update. Use Search Tasks to find task IDs.
>
> **user\_id** `string`
>
> ID of the task owner. Only applies to tasks with scheduled status.
>
> **priority** `string ("high" | "medium" | "low")`
>
> Task priority. For a scheduled task, include its current priority even when changing another field because Apollo resets an omitted priority to medium.
>
> **contact\_id** `string`
>
> Apollo ID of the contact associated with the task.
>
> **creator\_id** `string`
>
> ID of the task creator. For a scheduled task, include its current creator\_id even when changing another field because Apollo resets an omitted creator\_id to the API key's user.
>
> **call\_script** `string`
>
> Call script or talking points for a scheduled call task.
>
> **relevant\_fields** `array`
>
> Names of team-defined relevant fields to surface for a scheduled task.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] View API Usage Stats
>
> **Slug:** `APOLLO_VIEW_API_USAGE_STATS`
>
> Fetches Apollo API usage statistics and rate limits for the connected team. Use before large enrichment/search runs to understand current API usage and plan/budget constraints.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] View Credit Usage Stats
>
> **Slug:** `APOLLO_VIEW_CREDIT_USAGE_STATS`
>
> Read team balances by credit type for Apollo's current billing cycle. Balance values represent credits except for the `dialer` key, which Apollo reports in minutes. This operation is free.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
