Create Send

Starts an async campaign send for a saved email to a brand-owned audience. audienceId is required — the public surface only supports audience-scoped blasts. For per-recipient delivery driven by an event, use POST /v1/automation/runs (fire) against a published automation. POST supports idempotency for safe retries.

Optional emailVersionId pins to a specific email version. Omit to send the current latest.

Brand scoping: API keys are bound to a single brand. The send is always recorded against the API key brand and you cannot pass a brandId body field. Resources (emailId, audienceId) that exist in a different brand within the same organization are intentionally surfaced as 404 (rather than 403) so the API never confirms the existence of resources outside the caller brand.

POST /v1/sends

cURL

audience

curl --request POST \
  --url https://brew.new/api/v1/sends \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "emailId": "email_123",
  "domainId": "domain_123",
  "subject": "Welcome to Brew",
  "audienceId": "audience_123",
  "scheduledAt": "2099-01-01T00:00:00.000Z"
}
'

200

Example

{
  "status": "sent",
  "recipient": "[e-mail]"
}

Authorizations

bearerAuthapiKeyAuth

Authorization · string · header · default: Bearer brew_your_api_key · required

Send your Brew API key as Authorization: Bearer brew_xxx.

Headers

Idempotency-Key · string

Optional idempotency key for safe retries. Reusing the same key with the same request body returns the original response for 24 hours.

Required string length: 1 - 100

Body

application/json

Campaign send (audience-scoped, async 202) OR a test send ({ mode: "test", emailId, subject, to } — forced Brew sender, no domain/audience, sync 200).

Option 1

Option 2

mode · enum<string> · required

Available options: test

emailId · string · required

Minimum string length: 1

subject · string · required

Minimum string length: 1

to · string<email> · required

emailVersionId · string

Minimum string length: 1

previewText · string

Maximum string length: 50

replyTo · string<email>

Response

200

application/json

A test send completed (mode: "test").

status · enum<string> · required

Available options: sent

recipient · string<email> · required