Approved Custom accounts

Permission-based broadcast jobs.

The Broadcast API is asynchronous and account-scoped. A paid Custom plan and separate manual broadcast approval are both required. Free, unpaid, unapproved, restricted, suspended, or admission-closed accounts are rejected before delivery work or usage is created.

Policy and limits

Every recipient must have a documented permission basis. Supply an explicit recipient array; stored lists, scheduling, templates, segmentation, tracking, and automation are outside this contract. Cold outreach and purchased lists are prohibited. A job accepts at most 5,000 normalized unique recipients. One eligible accepted unique recipient is one recipient-email; suppressed or unsubscribed recipients consume neither usage nor delivery capacity.

Create a durable draft

Request

curl -X POST https://api.tenvio.email/v1/broadcasts \
  -H "Authorization: Bearer $TENVIO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: august-service-update" \
  -d '{"sender_identity_id":"11111111-1111-4111-8111-111111111111","subject":"Service update","text":"An update is available. An unsubscribe link will be appended.","recipients":["customer@example.net"],"audience_source":"Product opt-in form","subscription_scope":"service_updates","consent_attestation":{"attested":true,"basis":"express"},"organization_name":"Example Inc.","contact_information":"support@example.com"}'

The server records the authenticated actor and timestamp. Content and recipients become immutable when the job is sent.

Send, inspect, and cancel

Lifecycle requests

curl -X POST -H "Authorization: Bearer $TENVIO_API_KEY" https://api.tenvio.email/v1/broadcasts/$BROADCAST_ID/send
curl -H "Authorization: Bearer $TENVIO_API_KEY" https://api.tenvio.email/v1/broadcasts/$BROADCAST_ID
curl -H "Authorization: Bearer $TENVIO_API_KEY" https://api.tenvio.email/v1/broadcasts
curl -X POST -H "Authorization: Bearer $TENVIO_API_KEY" https://api.tenvio.email/v1/broadcasts/$BROADCAST_ID/cancel

Status is one of draft, queued, sending, completed, cancelled, or failed. Detail includes durable per-recipient counters for queued, sending, delivered, deferred, bounced, suppressed, unsubscribed, and cancelled outcomes.

Unsubscribe

Tenvio adds a visible recipient-specific HTTPS unsubscribe link plus List-Unsubscribe and List-Unsubscribe-Post: List-Unsubscribe=One-Click before DKIM signing. The opaque URL contains no email address. Its confirmation GET has no side effect; the login-free POST immediately and idempotently suppresses that normalized recipient for the account, sender identity, and subscription scope. Critical and transactional messages are unaffected by this broadcast-only unsubscribe.