SendStreak logo
menu

Abort an announcement

Stops an announcement for good. Works on a running or a paused announcement, and cannot be undone - an aborted announcement will never send again, and there is no endpoint to restart it. Use pause instead if you may want to continue later. As with pause, delivery stops at the next batch: recipients already handed to the mail server still receive their copy. An aborted announcement is deliberately distinct from a finished one, which ran out of audience on its own.

Endpoint

POST https://api.sendstreak.com/v2/accounts/{accountId}/announcements/{announcementId}/abort

All v2 endpoints require a bearer token - see Authentication.

Path parameters

Parameter Type Description
accountId string The account the request is scoped to.
announcementId string  

Response

The announcement, now aborted.

{
  "_id": "665f0a2b1c9d440012ab34cd",
  "name": "Example name",
  "templateId": "6650cc1d3e8a220013ef78ab",
  "subject": "Welcome to Acme!",
  "topicId": "6651dd2e4f9b110014ab90cd",
  "includeUnsubscribed": false,
  "attributes": [
    {
      "slug": "plan",
      "operator": "s_equal",
      "value": "professional"
    }
  ],
  "status": "running",
  "statusDetails": "Template not found",
  "processDate": "2026-07-07T09:30:00.000Z",
  "lastSampledContactId": "665f0a2b1c9d440012ab34cd",
  "createDate": "2026-07-07T09:30:00.000Z"
}

Errors

Status Description
401 Missing or invalid token, or the token is not authorized for this account/user.
404 The requested resource does not exist.
409 The resource is not in a state that allows this action. The message names the state it is in.

See Errors and rate limits for what error responses look like.

Curl example

curl --location --request POST 'https://api.sendstreak.com/v2/accounts/YOUR_ACCOUNT_ID/announcements/YOUR_ANNOUNCEMENT_ID/abort' \
--header 'Authorization: Bearer YOUR_API_TOKEN'
Try SendStreak for Free now!