Launch Campaign

Launch a draft campaign to begin sending mail. This validates wallet credits, enrolls recipients, and begins the sending pipeline.

Returns 402 Insufficient Credits if your wallet balance cannot cover the campaign cost. Use GET /campaigns/{id}/cost-estimate to check before launching.

The launch claims the campaign before preparing recipients and starting the sending pipeline. A competing or previously claimed launch returns 409 campaign_launch_claimed. Read the campaign's status and progress before retrying. If a launch failed after claiming the campaign, existing send records remain intact and require recovery; repeating the launch does not rebuild or erase them.

path idstringrequired

Campaign ID (UUID)

Request example

12curl -X POST https://api.v2.dealmachine.com/v1/mail/campaigns/a1b2c3d4/send \
  -H "Authorization: Bearer dm_sk_live_xxx"

Response example

12345678{
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": "active",
    "total_recipients": 150,
    "launched_at": "2026-03-11T14:23:45Z"
  }
}