Register a sending domain and get the DNS records to publish (scope: email_domains:write)
Returns the ownership TXT (`_brivio.<domain>`), SPF, DKIM selector record(s), DMARC and — when hosted — MX. Publish them, then call `/email-domains/{id}/verify`. 409 when the domain is already registered or claimed by another account; 503 when provisioning is not configured.
Returns the ownership TXT (_brivio.<domain>), SPF, DKIM selector record(s), DMARC and — when hosted — MX. Publish them, then call /email-domains/{id}/verify. 409 when the domain is already registered or claimed by another account; 503 when provisioning is not configured.
bearerAuthAuthorizationBearer <token>API key as Bearer token
application/json- body
domain*stringfrom_local_part?string"no-reply"OK
application/json- response
data*error*nullcurl -X POST "https://example.com/email-domains" \ -H "Content-Type: application/json" \ -d '{ "domain": "acme.ro", "from_local_part": "facturi" }'{ "data": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "domain": "string", "status": "pending", "verified": true, "from_local_part": "string", "dkim_selector": "string", "dns_records": [ { "type": "TXT", "name": "string", "value": "string", "status": "pending" } ], "checks": { "ownership": true, "spf": true, "dkim": true, "dmarc": true, "mx": true }, "last_error": "string", "verified_at": "2019-08-24T14:15:22Z", "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z" }, "error": null}Send transactional mail from a sibling application, RFC 5322 address strings (scope: emails:send) POST
Same pipeline as `/emails/send` (verified sender domain, fail-closed suppression, Safe Mode, outbox retry, `email.*` webhooks) with a flatter wire shape: addresses are strings (`"Ana <ana@x.ro>"`), `tags` is a key→value map, custom headers are allowed except envelope/MIME/authentication ones (From, To, Cc, Bcc, Subject, Reply-To, Message-ID, Date, Content-Type, DKIM-Signature, ARC-*, …; no CR/LF). `category` defaults to `transactional`; `auth` and `alert` are aliases for `transactional` and `notification`; `marketing` → 422. `from` on an unverified domain → 422 `from_domain_not_verified`; omit it for the org default sender. A `from` that no sending identity may send as → 422 `sender_identity_missing` (nothing recorded): use the sending address of the domain, or a hosted mailbox / alias with API sending enabled. 202 whenever the message is recorded — `status` is `sent`, `queued` (including a transport failure parked for retry) or `suppressed` (non-error). A transport refusal that could not be queued → 502 `send_failed`. `id`, `status` and `suppressed` are mirrored at the top level of the 202 body for clients that read them there. Honours `Idempotency-Key`. Shares the 600/h per-organisation limit with `/emails/send`.
Remove a sending domain (scope: email_domains:write) DELETE
Next Page