Pause an announcement

Stops a running announcement from sending any further batches. Delivery halts at the next batch boundary, not instantly: a batch already in flight finishes its recipients, because a message handed to the mail server cannot be recalled. The announcement keeps its progress and can be resumed. Only a running announcement can be paused; anything else is a 409 naming the state it is in.

Base URL https://api.sendstreak.com. All v2 endpoints require a bearer token - see Authentication.

Path parameters

Response

The announcement, now paused.

Errors

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

curl --location --request POST 'https://api.sendstreak.com/v2/accounts/YOUR_ACCOUNT_ID/announcements/YOUR_ANNOUNCEMENT_ID/pause' \
--header 'Authorization: Bearer YOUR_API_TOKEN'

const res = await fetch('https://api.sendstreak.com/v2/accounts/YOUR_ACCOUNT_ID/announcements/YOUR_ANNOUNCEMENT_ID/pause', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.SENDSTREAK_TOKEN}`
  }
});

import os, requests

res = requests.post(
    'https://api.sendstreak.com/v2/accounts/YOUR_ACCOUNT_ID/announcements/YOUR_ANNOUNCEMENT_ID/pause',
    headers={'Authorization': f"Bearer {os.environ['SENDSTREAK_TOKEN']}"},
)

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