Create sending domain
create_domainRegister a sending domain and get the exact DNS records to publish, plus TLS mode and tracking options. Use it to set up a domain before verifying it with verify_domain.
Instructions
Purpose: register a domain to send from, and get the exact DNS records to publish. NOT for: publishing those records — only whoever runs the DNS can do that — or checking them afterwards (verify_domain). Returns: the same domain view GET /domains/:id returns — every record with host, zone-relative name, value_strings, TTL, priority, required and observed, plus tls_mode (opportunistic by default, or enforced). The domain name is the name argument. Region is optional: us is the default, eu the other value. It is recorded on the domain; today all mail is sent from our US nodes, and eu domains move to EU sending automatically when it ships. A new domain reads pending while DNS spreads, which takes minutes to a day or two. Opportunistic — try TLS, fall back to plain when the receiver has none (the default). Enforced — refuse to deliver to a receiver that cannot do TLS; mail to such receivers bounces.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"name": "<name>"
},
"name": "create_domain"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Domain name, e.g. "acme.com". | |
| region | No | us or eu. Default us. Recorded on the domain; today all mail is sent from our US nodes, and eu domains move to EU sending automatically when it ships. Legacy names us-east-1, sa-east-1 and ap-northeast-1 map to us; eu-west-1 maps to eu. | |
| tls_mode | No | Opportunistic — try TLS, fall back to plain when the receiver has none (the default). Enforced — refuse to deliver to a receiver that cannot do TLS; mail to such receivers bounces. | |
| tracking | No | Include the tracking records. Default true. false omits them. Tracking is never required to verify. | |
| open_tracking | No | Record opens. Default false. Same field as POST /domains. | |
| click_tracking | No | Rewrite links and record clicks. Default false. Same field as POST /domains. | |
| idempotency_key | No | Your own key for this action. Retrying with the same key returns the first result instead of doing it twice — send one whenever a retry could double the effect. | |
| tracking_subdomain | No | Relative host for click and open links. Default links, which becomes links.yourdomain.com. | |
| return_path_subdomain | No | Label for the return-path host, up to 63 characters, starting with a letter. send is the default. Pick another label, such as bounce, when send already has an MX pointing elsewhere. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Identifier. | |
| name | No | ||
| error | No | Present instead of the fields above when the call was refused: code, message, fix, docs_url, retryable and, when waiting helps, retry_after_seconds. | |
| region | No | ||
| status | No | pending, verified, failed or temporary_failure. | |
| records | No | Each DNS record with its status. | |
| tls_mode | No | opportunistic or enforced. |