Skip to main content
POST
Update Contact Stage for Multiple Contacts
Move several contacts to a different stage at once. The stage id must come from get_apollo_contact_stages — stages are workspace-specific rather than a fixed enum, and an unknown id is rejected. Writes land in the AIsa workspace, which every caller shares: the record becomes visible and editable by others, and there is no per-caller isolation. Stage changes can trigger workspace automations.
First time? Point any MCP client at https://mcp.aisa.one/mcp — Claude Code, Codex, Cursor, VS Code and the rest. Authorization is OAuth: the client opens a browser, you click Allow once, and there is no key to paste. The commands per client, and what each call costs, are on aisa.one/mcp.
Set this endpoint up in your agent →

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

contact_ids[]
string
required

Contact IDs

contact_stage_id
string
required

New contact stage ID

Response

Successful response

contacts
string

Updated contacts

contacts[].id
string

Contact ID

contacts[].first_name
string

First name

contacts[].last_name
string

Last name

contacts[].contact_stage_id
string

Contact stage ID

contacts[].owner_id
string

Owner ID

contacts[].email
string

Email

contacts[].organization_name
string

Organization name