Add Contacts to a Sequence

Add contacts to an email sequence.

POST https://api.aisa.one/apis/v1/apollo/emailer_campaigns/{sequence_id}/add_contact_ids

Add Contacts to a Sequence

cURL

curl --request POST \
  --url https://api.aisa.one/apis/v1/apollo/emailer_campaigns/{sequence_id}/add_contact_ids \
  --header 'Authorization: Bearer <token>'

200

{
  "success": true
}

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. Your agent then reaches every endpoint through a few meta tools: search, list_categories, get_details and batch_quote are free, batch_use is billed per call. Setup per client is in Connect via MCP; the live tool list and what each call costs are on aisa.one/mcp.

Set this endpoint up in your agent →

Request contract

• Method and path: POST /apis/v1/apollo/emailer_campaigns/{sequence_id}/add_contact_ids
• Availability: enabled
• Request URL template: https://api.aisa.one/apis/v1/apollo/emailer_campaigns/{sequence_id}/add_contact_ids
• sequence_id: path; required
• contact_ids[]: query; optional
• emailer_campaign_id: query; required
• label_names[]: query; optional
• send_email_from_email_account_id: query; required
• send_email_from_email_address: query; optional
• sequence_active_in_other_campaigns: query; optional
• sequence_finished_in_other_campaigns: query; optional
• sequence_job_change: query; optional
• sequence_no_email: query; optional
• sequence_unverified_email: query; optional
• Runtime facts: 9ab7612cf2d53be794cbf1d65d4a257f986ac6783e53c7c3a5d868e4593061c3

Complete OpenAPI definition

Effective request and pricing declaration (including authentication and referenced schemas):

{
  "operationId": "post_apollo_emailer_campaigns_add_contact_ids",
  "method": "POST",
  "path": "/apis/v1/apollo/emailer_campaigns/{sequence_id}/add_contact_ids",
  "servers": [
    {
      "url": "https://api.aisa.one"
    }
  ],
  "parameters": [
    {
      "description": "Sequence (emailer campaign) ID.",
      "in": "path",
      "name": "sequence_id",
      "required": true,
      "schema": {
        "type": "string"
      }
    },
    {
      "description": "Contact IDs to add. Provide either contact_ids[] or label_names[] (or both).",
      "in": "query",
      "name": "contact_ids[]",
      "required": false,
      "schema": {
        "items": {
          "type": "string"
        },
        "type": "array"
      }
    },
    {
      "description": "Sequence ID (same as sequence_id).",
      "in": "query",
      "name": "emailer_campaign_id",
      "required": true,
      "schema": {
        "type": "string"
      }
    },
    {
      "description": "Label names for contacts to add. Provide either label_names[] or contact_ids[] (or both).",
      "in": "query",
      "name": "label_names[]",
      "required": false,
      "schema": {
        "items": {
          "type": "string"
        },
        "type": "array"
      }
    },
    {
      "description": "Email account ID (or IDs) to send from.",
      "in": "query",
      "name": "send_email_from_email_account_id",
      "required": true,
      "schema": {
        "type": "string"
      }
    },
    {
      "description": "Optional from-address alias.",
      "in": "query",
      "name": "send_email_from_email_address",
      "required": false,
      "schema": {
        "type": "string"
      }
    },
    {
      "description": "Allow contacts active in other sequences.",
      "in": "query",
      "name": "sequence_active_in_other_campaigns",
      "required": false,
      "schema": {
        "type": "boolean"
      }
    },
    {
      "description": "Allow contacts finished in other sequences.",
      "in": "query",
      "name": "sequence_finished_in_other_campaigns",
      "required": false,
      "schema": {
        "type": "boolean"
      }
    },
    {
      "description": "Allow contacts with job change.",
      "in": "query",
      "name": "sequence_job_change",
      "required": false,
      "schema": {
        "type": "boolean"
      }
    },
    {
      "description": "Allow contacts without email.",
      "in": "query",
      "name": "sequence_no_email",
      "required": false,
      "schema": {
        "type": "boolean"
      }
    },
    {
      "description": "Allow contacts with unverified email.",
      "in": "query",
      "name": "sequence_unverified_email",
      "required": false,
      "schema": {
        "type": "boolean"
      }
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "x-aisa-status": "enabled",
  "x-aisa-pricing": {
    "cost_contract": "fixed_success",
    "customer_pricing": "fixed_success",
    "default_request_estimate_usd": 0.012,
    "estimate_source": "profile_seed",
    "evidence_source": "request_snapshot"
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "scheme": "bearer",
        "type": "http"
      }
    }
  }
}

Cost and request rules

Published reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.

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

200

application/json

Successful response

success · boolean

Whether the add succeeded (when returned).