Skip to main content
POST
Add Contacts to a Sequence
Add contacts to an email sequence. ⚠️ This is the endpoint that causes real email to be sent: once added to an active sequence, contacts start receiving its steps from the workspace’s connected mailboxes. Get the sequence id from post_apollo_emailer_campaigns_search and confirm its state before adding anyone. 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. Sending cannot be recalled once a step goes out.
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 →

Cost and request rules

Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.
  • Default request reference estimate (USD): 0.012
  • Cost contract: fixed_success
  • Settlement evidence source: request_snapshot

Authorizations

Authorization
string
header
required

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

Path Parameters

sequence_id
string
required

Sequence (emailer campaign) ID.

Query Parameters

contact_ids[]
string[]

Contact IDs to add. Provide either contact_ids[] or label_names[] (or both).

emailer_campaign_id
string
required

Sequence ID (same as sequence_id).

label_names[]
string[]

Label names for contacts to add. Provide either label_names[] or contact_ids[] (or both).

send_email_from_email_account_id
string
required

Email account ID (or IDs) to send from.

send_email_from_email_address
string

Optional from-address alias.

sequence_active_in_other_campaigns
boolean

Allow contacts active in other sequences.

sequence_finished_in_other_campaigns
boolean

Allow contacts finished in other sequences.

sequence_job_change
boolean

Allow contacts with job change.

sequence_no_email
boolean

Allow contacts without email.

sequence_unverified_email
boolean

Allow contacts with unverified email.

Response

Successful response

success
boolean

Whether the add succeeded (when returned).