>_

SpendSignoff documentation

The always-on operator for your ad accounts. Read and draft from your AI client — approve before anything goes live.

API reference / General

Switch Primary Account

POST/v1/general/switch-primary-account

Switch Primary Account on your connected accounts. Returns a draft with a before→after diff; a human approves it in the SpendSignoff dashboard before anything goes live.

Write tools return drafts

This endpoint stages a change as a draft with a before→after diff. A human approves it with the two-step control in the SpendSignoff dashboard before any spend moves — the model can never push it live.

Parameters

NameTypeRequiredDescription
account_idstringyesThe connected ad account ID.

Example request

POST /v1/general/switch-primary-account

{
  "account_id": "account_a91f"
}

Example response

201 — draft created

{
  "draft_id": "draft_7c2e",
  "status": "pending_approval",
  "diff": {
    "field": "daily_budget",
    "before": 100,
    "after": 120
  },
  "requires": "human_two_step_approve"
}

More General endpoints

    Switch Primary Account — General API — SpendSignoff