Skip to main content
POST
Register an email sender

Authorizations

Authorization
string
header
required

Dashboard JWT token from Clerk

Body

application/json
domain
string
required

Sending domain to register (lowercased), e.g. mail.acme.com.

default_from_email
null | string

Default From address — must be on domain; omit or null to send as noreply@<domain>.

default_from_name
null | string

Display name shown to recipients.

default_reply_to
null | string

Reply-To routing address.

isDefault
boolean

Make this the org's default sender (demotes the previous default).

streamId
null | string

Assign the sender to a sending stream (estream_…), or null to leave it unassigned.

Response

201 - application/json

The created email sender.

data
object

A verified email sending identity for the tenant — a sending domain plus its default from-fields, reply-to, sending-stream assignment, and derived DNS-verification state.

meta
object