Autopilot

Start an autopilot run

Creates an autopilot run for the given website. The run works autonomously up to the approval gate: it builds the customer profile, drafts the sequence and checks, without spending credits, that prospects match the profile. Nothing is spent, bought or sent before a human approves the run: no credits are reserved and no prospect is revealed until then, and approving is what reveals the first batch of prospects. When budgetUsd is given the sized budget plan is returned and snapshotted on the run, and targetProspects defaults to the plan's monthly prospect capacity. The plan's domain and mailbox counts are a ceiling, not a quote: one infrastructure order buys at most 10 domains, can place fewer mailboxes than the plan, and buys nothing when the workspace already has a connected sending account. Its dollar figures are an estimate, and an order is charged at the prices in force when it is placed. replyMode controls how inbound replies are handled (off, draft, approve, auto; default draft); auto sends AI reply drafts for interested replies without review. Available on every plan, and requires an active subscription. A workspace may have only one run awaiting approval at a time, and a limited number of starts per day.

post/autopilot/runs

Request

  • Base URL: https://api.emailchaser.com/r
  • URL: https://api.emailchaser.com/r/autopilot/runs
  • Auth: HTTP bearer

Request body

budgetUsdnumber

BudgetUsd, when given, sizes a budget plan that is snapshotted on the run. The plan's domain and mailbox counts are a ceiling for what the run buys after approval (one order holds at most 10 domains and can place fewer mailboxes), and its dollar figures are an estimate.

chosenDomainstring

ChosenDomain is the .com domain to buy for a starter-kit run. Checked with the registrar before the run is created.

mailboxUsernamesstring[]

MailboxUsernames are the one to three mailbox local parts to create on that domain. The mailboxes are created under the workspace owner's real name.

maxMailboxesinteger

MaxMailboxes caps the budget plan's infrastructure. 0 means no cap.

replyModestring

ReplyMode is how inbound replies are handled: off, draft (default), approve, or auto. Auto sends AI reply drafts for interested replies without review - opt in deliberately.

scaleRunboolean

ScaleRun marks this run as a scale step for a workspace that already sends. Without it the run buys nothing when a mailbox is already connected, which is right for a first run and wrong for a second one. The run's infrastructure is sized as an ADDITION to the current fleet: with BudgetUsd by the same planner GET /autopilot/scale-plan uses for CUSTOM, without it by the DOUBLE preset. Ignored with StarterKit. The run still parks at the approval gate.

starterKitboolean

StarterKit buys the launch starter kit instead of sizing from a budget: one .com domain, up to three mailboxes and the first 50 prospects, at the intro prices when the workspace is still eligible for them. ChosenDomain and MailboxUsernames are required with it, BudgetUsd and TargetProspects are ignored, and the resulting run can only be APPROVED in the Emailchaser app - this API refuses to approve one.

targetProspectsinteger

TargetProspects is how many prospects the run reveals per sourcing batch: the first batch once the run is approved, then each top-up. No prospect is revealed and no credit is spent before approval. When omitted and a budget is given, it is derived from the budget plan; when 0 or omitted without a budget, the runner default batch applies.

websitestring required

Website is the company website the run is seeded from.

Example request

{
  "budgetUsd": 500,
  "chosenDomain": "acme-mail.com",
  "mailboxUsernames": [
    "jane",
    "jane.doe",
    "hello"
  ],
  "maxMailboxes": 20,
  "replyMode": "draft",
  "starterKit": true,
  "targetProspects": 500,
  "website": "https://acme.com"
}

Response

The created run, with the plan when a budget was given

Example response

{
  "plan": {
    "credits": 2310,
    "creditsUsd": 57.75,
    "domains": 5,
    "expectedMeetingsPerMonth": 6.1,
    "feasible": true,
    "firstMonthUsd": 539.7,
    "mailboxes": 14,
    "mailboxesMonthlyUsd": 70,
    "monthlySends": 9240,
    "prospectsPerMonth": 2310,
    "recurringUsd": 427.75,
    "setupUsd": 111.95
  },
  "run": {
    "approvedAt": "2026-07-01T10:30:00Z",
    "approvedByUserId": 3,
    "audit": [
      {
        "actor": "system",
        "at": "2026-07-01T10:30:00Z",
        "message": "found prospects to reveal; no credits spent, waiting for approval before revealing them",
        "stage": "awaiting_approval"
      }
    ],
    "campaignId": 1234,
    "chosenDomain": "acme-mail.com",
    "createdAt": "2026-07-01T10:30:00Z",
    "icpId": 12,
    "id": 7,
    "lastAdvancedAt": "2026-07-01T10:30:00Z",
    "mailboxUsernames": [
      "jane",
      "hello"
    ],
    "prospectSearchId": 56,
    "replyMode": "draft",
    "status": "awaiting_approval",
    "targetProspectCount": 500,
    "website": "https://acme.com"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.