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_..."
  }
}

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

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

Required for smtp delivery_type. Array of SMTP servers

Server URL

Example:

"mail.example.com:25"

​
webhook_url
string<uri>

Required for webhook delivery_type. Webhook URL to receive emails

Example:

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

​
webhook_method
enum<string>
default:POST

HTTP method for webhook

Available options:
POST,
PUT
​
webhook_headers
object

Custom headers to send with webhook requests

​
webhook_timeout
integer
default:30000

Webhook timeout in milliseconds

​
webhook_retry_count
integer
default:3

Number of retry attempts for failed webhook calls

​
webhook_auth_header
string

Authorization header value for webhook

Response

Domain added successfully

​
success
boolean
Example:

true

​
result
object