Skip to main content
POST
/
inbound
/
domains
curl --request POST \
  --url https://api.jetemail.com/inbound/domains \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "domain": "example.com",
  "delivery_type": "smtp",
  "smtp_servers": [
    {
      "url": "mail.example.com:25",
      "priority": 1,
      "tls_enabled": true
    }
  ]
}
'
{
  "success": true,
  "result": {
    "domain": "example.com",
    "delivery_type": "smtp",
    "status": "active",
    "uuid": "550e8400-e29b-41d4-a716-446655440000",
    "webhook_secret": "whsec_...",
    "forward_mx_verified": 0,
    "forward_dkim_verified": 0,
    "forward_spf_verified": 0,
    "forward_dmarc_verified": 0
  }
}

Documentation Index

Fetch the complete documentation index at: https://jetemail.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

API key for account management endpoints. Use your api_ prefixed token.

Body

application/json
​
domain
string
required

Primary domain name to add (e.g., example.com, not mail.example.com)

Pattern: ^(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?.)+[a-zA-Z]{2,}$
Example:

"example.com"

​
delivery_type
enum<string>
required

How emails should be delivered for this domain. For "forward", inbound mail is forwarded to per-recipient destinations defined via POST /inbound/domains/{uuid}/forward-rules.

Available options:
smtp,
webhook,
forward
​
smtp_servers
(string | object)[]

Only for delivery_type=smtp (required). Rejected with 400 if sent with webhook or forward.

Server URL

Example:

"mail.example.com:25"

​
webhook_url
string<uri>

Only for delivery_type=webhook (required). Webhook URL to receive emails. Rejected with 400 if sent with smtp or forward.

Example:

"https://example.com/webhook/inbound"

​
webhook_method
enum<string>
default:POST

Only for delivery_type=webhook. HTTP method for webhook. Rejected with 400 if sent with smtp or forward.

Available options:
POST,
PUT
​
webhook_headers
object

Only for delivery_type=webhook. Custom headers to send with webhook requests. Rejected with 400 if sent with smtp or forward.

​
webhook_timeout
integer
default:30000

Only for delivery_type=webhook. Webhook timeout in milliseconds. Rejected with 400 if sent with smtp or forward.

​
webhook_retry_count
integer
default:3

Only for delivery_type=webhook. Number of retry attempts for failed webhook calls. Rejected with 400 if sent with smtp or forward.

​
webhook_auth_header
string

Only for delivery_type=webhook. Authorization header value for webhook. Rejected with 400 if sent with smtp or forward.

Response

Domain added successfully

​
success
boolean
Example:

true

​
result
object