> This page is for Agent Handler.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# Apollo

**Authentication:** API key. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow.

## Sample use cases

* Build a list of VPs of Engineering at Series B SaaS companies with 100-500 employees in the US, then enrich with verified emails.
* Find companies that hired their first head of security in the last 90 days.
* Sequence outreach to the 50 newest accounts added to our CRM this week.

## Available Tools

#### create\_account

Create a new account/company in Apollo CRM. Name is required. Optionally set domain, owner, stage, and custom fields.

#### get\_account

Get an account by ID from Apollo CRM. Returns full account details including contacts count.

#### update\_account

Update an existing account in Apollo CRM. Only provided fields will be updated.

#### search\_accounts

Search accounts in Apollo CRM by keywords, stage, owner, or labels. Supports filtering by contact count.

#### list\_account\_stages

List all available account stages in Apollo CRM. Use stage IDs when creating or updating accounts.

#### update\_account\_stages

Update the stage for multiple accounts at once. Provide account IDs and the new stage ID.

#### update\_account\_owners

Reassign ownership of multiple accounts to a different user. Provide account IDs and new owner ID.

#### create\_contact

Create a new contact in Apollo CRM. Provide name, email, title, company, and optional account association.

#### get\_contact

Get a contact by ID from Apollo CRM. Returns full contact details including custom fields.

#### update\_contact

Update an existing contact in Apollo CRM. Only provided fields will be updated.

#### search\_contacts

Search contacts in Apollo CRM by keywords, stage, owner, account, or labels. Supports sorting and pagination.

#### list\_contact\_stages

List all available contact stages in Apollo CRM. Use stage IDs when creating or updating contacts.

#### update\_contact\_stages

Update the stage for multiple contacts at once. Provide contact IDs and the new stage ID.

#### update\_contact\_owners

Reassign ownership of multiple contacts to a different user. Provide contact IDs and new owner ID.

#### create\_opportunity

Create a new deal/opportunity in Apollo CRM. Name is required. Optionally set amount, close date, stage, and associations.

#### get\_opportunity

Get an opportunity/deal by ID from Apollo CRM. Returns full deal details including stage and associations.

#### update\_opportunity

Update an existing opportunity in Apollo CRM. Change stage, amount, close date, or mark as won/lost.

#### search\_opportunities

Search opportunities in Apollo CRM pipeline. Filter by stage, owner, account, amount range, or close date.

#### enrich\_organization

Enrich company data by domain. Returns company details including size, industry, funding, technologies, and social profiles.

#### bulk\_enrich\_organizations

Bulk enrich multiple companies by domain. Read-only operation that returns company details for each domain.

#### search\_organizations

Search Apollo database for companies by name, industry keywords, location, or employee count. Returns company profiles.

#### get\_organization\_job\_postings

Get current job postings for a company by Apollo organization ID. Useful for understanding hiring activity and company growth.

#### search\_people

Search Apollo database for people by title, seniority, location, company domain, or keywords. Returns contact info and company details.

#### enrich\_person

Enrich a person's profile by email, LinkedIn URL, or name+company domain. Returns full contact details, employment history, and social profiles.

#### bulk\_enrich\_people

Bulk enrich multiple people profiles at once. Provide list of email, LinkedIn URL, or name+domain combinations. Read-only, safe operation.

#### list\_email\_accounts

List email accounts/mailboxes linked to Apollo. Returns email account IDs needed for add\_contacts\_to\_sequence. Requires master API key.

#### search\_sequences

Search email sequences in Apollo. Filter by active/archived status. Returns sequence details with performance metrics.

#### add\_contacts\_to\_sequence

Add one or more contacts to an email sequence. Optionally specify email account to send from and override settings.

#### update\_contact\_sequence\_status

Remove a contact from a sequence or mark them as finished. Use 'remove' to stop the sequence, 'finished' to mark as completed.

#### create\_task

Create a sales task/reminder in Apollo. Requires user\_id, contact\_ids (array), priority, due\_at, and type. Tasks are created for each contact.

#### search\_tasks

Search tasks in Apollo. Filter by assignee, contact, account, type, priority, status, or due date range.