Cancel Campaign

Cancel a campaign. A ready, active, or paused campaign ends the same way as End Campaign (POST /v1/mail/campaigns/{id}/end), with the same response. Unsent mail is stopped. Mail that has already been submitted to the vendor will still be delivered; it cannot be recalled. A draft is cancelled as before.

The campaign's status becomes ended. Campaigns cancelled before October 14, 2026 also read ended. Cancelling a campaign that has already ended changes nothing and returns it with 200, stopped_mail_count: 0 and already_printed_count: 0, so retries are safe.

path idstringrequired

Campaign ID (UUID)

Request example

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

Response example

12345678910111213{
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Spring Seller Campaign",
    "status": "ended",
    "is_accepting_properties": true,
    "can_add_properties": false,
    "total_recipients": 150,
    "total_sent": 120
  },
  "stopped_mail_count": 12,
  "already_printed_count": 3
}