menu
Create an announcement
Creates and starts an announcement: a one-off campaign email rendered from the referenced template for the audience selected by topic and filter. Delivery begins asynchronously on creation, and announcements are create-only - there is no update path.
Endpoint
POST https://api.sendstreak.com/v2/accounts/{accountId}/announcements
All v2 endpoints require a bearer token - see Authentication.
Path parameters
| Parameter | Type | Description |
|---|---|---|
accountId | string | The account the request is scoped to. |
Request body
| Field | Type | Required | Description |
|---|---|---|---|
_id | string | no | |
name | string | yes | Internal campaign name, shown on the dashboard - recipients never see it. |
templateId | string | yes | Id of the email template to send. |
topicId | string | no | Announcement topic the campaign belongs to; contacts unsubscribed from it are skipped. |
includeUnsubscribed | boolean | no | Send to unsubscribed contacts too - only for messages they must receive, like terms changes. |
status | string | no | Delivery status; server-managed. |
createDate | string (date-time) | no | Server-set creation time. |
Response
The created announcement.
{
"_id": "665f0a2b1c9d440012ab34cd",
"name": "Example name",
"templateId": "6650cc1d3e8a220013ef78ab",
"topicId": "6651dd2e4f9b110014ab90cd",
"includeUnsubscribed": false,
"status": "queued",
"createDate": "2026-07-07T09:30:00.000Z"
}
Errors
| Status | Description |
|---|---|
400 | The request body or parameters failed validation. |
401 | Missing or invalid token, or the token is not authorized for this account/user. |
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' \
--header 'Authorization: Bearer YOUR_API_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
"_id": "665f0a2b1c9d440012ab34cd",
"name": "Example name",
"templateId": "6650cc1d3e8a220013ef78ab",
"topicId": "6651dd2e4f9b110014ab90cd",
"includeUnsubscribed": false,
"status": "queued",
"createDate": "2026-07-07T09:30:00.000Z"
}'