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.

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"
  }
}