Skip to main content
POST
Create or find a sending domain

Authorizations

Authorization
string
header
required

API Key authentication. Secret keys (sk_*) are required for all endpoints except /v1/track. Public keys (pk_*) only work with the /v1/track endpoint for client-side event tracking. Workspaces can have multiple active keys, and sender-domain operations enforce per-key domain scope when configured.

Body

application/json
domain
string<hostname>
required

Exact sending domain or subdomain. Wildcards, IP addresses, and local hostnames are rejected.

Example:

"portal.example.com"

Response

Existing domain returned

success
enum<boolean>
required
Available options:
true
data
object
required