# Sending Domains
Configure and verify domains for email sending to ensure deliverability.
## List sending domains
> Get all sending domains and their verification status
```json
{"openapi":"3.1.0","info":{"title":"Email Sending","version":"2.0.0"},"tags":[{"name":"domains","description":"Configure and verify domains for email sending to ensure deliverability.\n"}],"servers":[{"description":"Mailtrap API","url":"https://mailtrap.io"}],"security":[{"HeaderAuth":[]},{"BearerAuth":[]}],"components":{"securitySchemes":{"HeaderAuth":{"type":"apiKey","description":"API token in Api-Token header","in":"header","name":"Api-Token"},"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer token authentication"}},"parameters":{"account_id":{"name":"account_id","in":"path","required":true,"description":"Account ID","schema":{"type":"integer"}}},"responses":{"SendingDomainsResponse":{"description":"List of sending domains","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/SendingDomain"}}}}}}},"Unauthorized":{"description":"Unauthorized. Check your API credentials.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"Forbidden":{"description":"Forbidden. Verify domain or check permissions.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"schemas":{"SendingDomain":{"type":"object","properties":{"id":{"type":"integer"},"domain_name":{"type":"string"},"demo":{"type":"boolean"},"compliance_status":{"type":"string","description":"Indicates the compliance verification status of the sending domain.\nThe domain must reach `compliant` status before you can send emails\nin production.\n\n- `demo` - A demo domain provided by Mailtrap. Can only send emails to the account owner.\n- `demo_exhausted` - A demo domain that has used up its sending allowance. Cannot send emails.\n- `unverified_dns` - Domain DNS records have not been verified yet. Open your domain on the [Sending Domains](https://mailtrap.io/domains) page and follow the [Sending Domain Setup](https://docs.mailtrap.io/email-api-smtp/setup/sending-domain) guide.\n- `missing_company_info` - Account is missing required company information. Go to [Company Information](https://mailtrap.io/settings/account?current_tab=company_information) and fill in the required details.\n- `under_review` - Domain is undergoing automatic compliance review. No action needed — typically completes within 2 minutes.\n- `awaiting_questionnaire` - Automatic review required additional information. Open your domain on the [Sending Domains](https://mailtrap.io/domains) page and fill in the compliance questionnaire.\n- `awaiting_card_verification` - Compliance questionnaire was submitted but credit card identity verification is still needed. Open your domain on the [Sending Domains](https://mailtrap.io/domains) page and enter card details. The charged amount is refunded immediately and the card is not stored.\n- `non_compliant` - Domain did not pass compliance checks. Sending is not allowed. Contact [Mailtrap Support](mailto:support@mailtrap.io) for details and next steps.\n- `compliant` - Domain has passed all compliance checks and is ready to send emails.\n- `suspended` - Domain sending has been suspended. Contact [Mailtrap Support](mailto:support@mailtrap.io) to resolve the issue.\n","enum":["demo","demo_exhausted","unverified_dns","missing_company_info","under_review","awaiting_questionnaire","awaiting_card_verification","non_compliant","compliant","suspended"]},"dns_verified":{"type":"boolean"},"dns_verified_at":{"type":["string","null"]},"dns_records":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"domain":{"type":"string"},"name":{"type":"string"},"status":{"type":"string","enum":["pass","fail","unchecked","missing","softfail","network_error"]},"type":{"type":"string"},"value":{"type":"string"}}}},"open_tracking_enabled":{"type":"boolean"},"click_tracking_enabled":{"type":"boolean"},"auto_unsubscribe_link_enabled":{"type":"boolean"},"custom_domain_tracking_enabled":{"type":"boolean"},"health_alerts_enabled":{"type":"boolean"},"critical_alerts_enabled":{"type":"boolean"},"alert_recipient_email":{"type":["string","null"]},"permissions":{"type":"object","properties":{"can_read":{"type":"boolean"},"can_update":{"type":"boolean"},"can_destroy":{"type":"boolean"}}}}},"ErrorResponse":{"type":"object","properties":{"success":{"type":"boolean"},"errors":{"type":"array","items":{"type":"string"}}}}}},"paths":{"/api/accounts/{account_id}/sending_domains":{"get":{"summary":"List sending domains","description":"Get all sending domains and their verification status","operationId":"getSendingDomains","tags":["domains"],"parameters":[{"$ref":"#/components/parameters/account_id"}],"responses":{"200":{"$ref":"#/components/responses/SendingDomainsResponse"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}}}}
```
## Create sending domain
> Create a sending domain for email authentication. After creation, verify the domain by adding DNS records.\
> \
> \*\*Process:\*\*\
> 1\. Create the domain\
> 2\. Add DNS records (SPF, DKIM, DMARC)\
> 3\. Verify the records\
> 4\. Start sending emails
```json
{"openapi":"3.1.0","info":{"title":"Email Sending","version":"2.0.0"},"tags":[{"name":"domains","description":"Configure and verify domains for email sending to ensure deliverability.\n"}],"servers":[{"description":"Mailtrap API","url":"https://mailtrap.io"}],"security":[{"HeaderAuth":[]},{"BearerAuth":[]}],"components":{"securitySchemes":{"HeaderAuth":{"type":"apiKey","description":"API token in Api-Token header","in":"header","name":"Api-Token"},"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer token authentication"}},"parameters":{"account_id":{"name":"account_id","in":"path","required":true,"description":"Account ID","schema":{"type":"integer"}}},"responses":{"SendingDomainResponse":{"description":"Sending domain details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendingDomain"}}}},"Unauthorized":{"description":"Unauthorized. Check your API credentials.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"Forbidden":{"description":"Forbidden. Verify domain or check permissions.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"UnprocessableEntity":{"description":"Validation errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"}}}}},"schemas":{"SendingDomain":{"type":"object","properties":{"id":{"type":"integer"},"domain_name":{"type":"string"},"demo":{"type":"boolean"},"compliance_status":{"type":"string","description":"Indicates the compliance verification status of the sending domain.\nThe domain must reach `compliant` status before you can send emails\nin production.\n\n- `demo` - A demo domain provided by Mailtrap. Can only send emails to the account owner.\n- `demo_exhausted` - A demo domain that has used up its sending allowance. Cannot send emails.\n- `unverified_dns` - Domain DNS records have not been verified yet. Open your domain on the [Sending Domains](https://mailtrap.io/domains) page and follow the [Sending Domain Setup](https://docs.mailtrap.io/email-api-smtp/setup/sending-domain) guide.\n- `missing_company_info` - Account is missing required company information. Go to [Company Information](https://mailtrap.io/settings/account?current_tab=company_information) and fill in the required details.\n- `under_review` - Domain is undergoing automatic compliance review. No action needed — typically completes within 2 minutes.\n- `awaiting_questionnaire` - Automatic review required additional information. Open your domain on the [Sending Domains](https://mailtrap.io/domains) page and fill in the compliance questionnaire.\n- `awaiting_card_verification` - Compliance questionnaire was submitted but credit card identity verification is still needed. Open your domain on the [Sending Domains](https://mailtrap.io/domains) page and enter card details. The charged amount is refunded immediately and the card is not stored.\n- `non_compliant` - Domain did not pass compliance checks. Sending is not allowed. Contact [Mailtrap Support](mailto:support@mailtrap.io) for details and next steps.\n- `compliant` - Domain has passed all compliance checks and is ready to send emails.\n- `suspended` - Domain sending has been suspended. Contact [Mailtrap Support](mailto:support@mailtrap.io) to resolve the issue.\n","enum":["demo","demo_exhausted","unverified_dns","missing_company_info","under_review","awaiting_questionnaire","awaiting_card_verification","non_compliant","compliant","suspended"]},"dns_verified":{"type":"boolean"},"dns_verified_at":{"type":["string","null"]},"dns_records":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"domain":{"type":"string"},"name":{"type":"string"},"status":{"type":"string","enum":["pass","fail","unchecked","missing","softfail","network_error"]},"type":{"type":"string"},"value":{"type":"string"}}}},"open_tracking_enabled":{"type":"boolean"},"click_tracking_enabled":{"type":"boolean"},"auto_unsubscribe_link_enabled":{"type":"boolean"},"custom_domain_tracking_enabled":{"type":"boolean"},"health_alerts_enabled":{"type":"boolean"},"critical_alerts_enabled":{"type":"boolean"},"alert_recipient_email":{"type":["string","null"]},"permissions":{"type":"object","properties":{"can_read":{"type":"boolean"},"can_update":{"type":"boolean"},"can_destroy":{"type":"boolean"}}}}},"ErrorResponse":{"type":"object","properties":{"success":{"type":"boolean"},"errors":{"type":"array","items":{"type":"string"}}}},"UnprocessableEntity":{"type":"object","properties":{"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}}}}}},"paths":{"/api/accounts/{account_id}/sending_domains":{"post":{"summary":"Create sending domain","description":"Create a sending domain for email authentication. After creation, verify the domain by adding DNS records.\n\n**Process:**\n1. Create the domain\n2. Add DNS records (SPF, DKIM, DMARC)\n3. Verify the records\n4. Start sending emails\n","operationId":"createSendingDomain","tags":["domains"],"parameters":[{"$ref":"#/components/parameters/account_id"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["sending_domain"],"properties":{"sending_domain":{"type":"object","required":["domain_name"],"properties":{"domain_name":{"type":"string","format":"hostname","description":"Your domain name"}}}}}}}},"responses":{"200":{"$ref":"#/components/responses/SendingDomainResponse"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"422":{"$ref":"#/components/responses/UnprocessableEntity"}}}}}}
```
## Get sending domain
> Get details and verification status of a specific sending domain
```json
{"openapi":"3.1.0","info":{"title":"Email Sending","version":"2.0.0"},"tags":[{"name":"domains","description":"Configure and verify domains for email sending to ensure deliverability.\n"}],"servers":[{"description":"Mailtrap API","url":"https://mailtrap.io"}],"security":[{"HeaderAuth":[]},{"BearerAuth":[]}],"components":{"securitySchemes":{"HeaderAuth":{"type":"apiKey","description":"API token in Api-Token header","in":"header","name":"Api-Token"},"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer token authentication"}},"parameters":{"account_id":{"name":"account_id","in":"path","required":true,"description":"Account ID","schema":{"type":"integer"}},"sending_domain_id":{"name":"sending_domain_id","in":"path","required":true,"description":"Sending domain ID","schema":{"type":"integer"}}},"responses":{"SendingDomainResponse":{"description":"Sending domain details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendingDomain"}}}},"Unauthorized":{"description":"Unauthorized. Check your API credentials.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"Forbidden":{"description":"Forbidden. Verify domain or check permissions.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"NotFound":{"description":"Resource not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}},"schemas":{"SendingDomain":{"type":"object","properties":{"id":{"type":"integer"},"domain_name":{"type":"string"},"demo":{"type":"boolean"},"compliance_status":{"type":"string","description":"Indicates the compliance verification status of the sending domain.\nThe domain must reach `compliant` status before you can send emails\nin production.\n\n- `demo` - A demo domain provided by Mailtrap. Can only send emails to the account owner.\n- `demo_exhausted` - A demo domain that has used up its sending allowance. Cannot send emails.\n- `unverified_dns` - Domain DNS records have not been verified yet. Open your domain on the [Sending Domains](https://mailtrap.io/domains) page and follow the [Sending Domain Setup](https://docs.mailtrap.io/email-api-smtp/setup/sending-domain) guide.\n- `missing_company_info` - Account is missing required company information. Go to [Company Information](https://mailtrap.io/settings/account?current_tab=company_information) and fill in the required details.\n- `under_review` - Domain is undergoing automatic compliance review. No action needed — typically completes within 2 minutes.\n- `awaiting_questionnaire` - Automatic review required additional information. Open your domain on the [Sending Domains](https://mailtrap.io/domains) page and fill in the compliance questionnaire.\n- `awaiting_card_verification` - Compliance questionnaire was submitted but credit card identity verification is still needed. Open your domain on the [Sending Domains](https://mailtrap.io/domains) page and enter card details. The charged amount is refunded immediately and the card is not stored.\n- `non_compliant` - Domain did not pass compliance checks. Sending is not allowed. Contact [Mailtrap Support](mailto:support@mailtrap.io) for details and next steps.\n- `compliant` - Domain has passed all compliance checks and is ready to send emails.\n- `suspended` - Domain sending has been suspended. Contact [Mailtrap Support](mailto:support@mailtrap.io) to resolve the issue.\n","enum":["demo","demo_exhausted","unverified_dns","missing_company_info","under_review","awaiting_questionnaire","awaiting_card_verification","non_compliant","compliant","suspended"]},"dns_verified":{"type":"boolean"},"dns_verified_at":{"type":["string","null"]},"dns_records":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"domain":{"type":"string"},"name":{"type":"string"},"status":{"type":"string","enum":["pass","fail","unchecked","missing","softfail","network_error"]},"type":{"type":"string"},"value":{"type":"string"}}}},"open_tracking_enabled":{"type":"boolean"},"click_tracking_enabled":{"type":"boolean"},"auto_unsubscribe_link_enabled":{"type":"boolean"},"custom_domain_tracking_enabled":{"type":"boolean"},"health_alerts_enabled":{"type":"boolean"},"critical_alerts_enabled":{"type":"boolean"},"alert_recipient_email":{"type":["string","null"]},"permissions":{"type":"object","properties":{"can_read":{"type":"boolean"},"can_update":{"type":"boolean"},"can_destroy":{"type":"boolean"}}}}},"ErrorResponse":{"type":"object","properties":{"success":{"type":"boolean"},"errors":{"type":"array","items":{"type":"string"}}}}}},"paths":{"/api/accounts/{account_id}/sending_domains/{sending_domain_id}":{"get":{"summary":"Get sending domain","description":"Get details and verification status of a specific sending domain","operationId":"getSendingDomain","tags":["domains"],"parameters":[{"$ref":"#/components/parameters/account_id"},{"$ref":"#/components/parameters/sending_domain_id"}],"responses":{"200":{"$ref":"#/components/responses/SendingDomainResponse"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}}}}
```
## Delete sending domain
> Remove a sending domain from your account
```json
{"openapi":"3.1.0","info":{"title":"Email Sending","version":"2.0.0"},"tags":[{"name":"domains","description":"Configure and verify domains for email sending to ensure deliverability.\n"}],"servers":[{"description":"Mailtrap API","url":"https://mailtrap.io"}],"security":[{"HeaderAuth":[]},{"BearerAuth":[]}],"components":{"securitySchemes":{"HeaderAuth":{"type":"apiKey","description":"API token in Api-Token header","in":"header","name":"Api-Token"},"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer token authentication"}},"parameters":{"account_id":{"name":"account_id","in":"path","required":true,"description":"Account ID","schema":{"type":"integer"}},"sending_domain_id":{"name":"sending_domain_id","in":"path","required":true,"description":"Sending domain ID","schema":{"type":"integer"}}},"responses":{"Unauthorized":{"description":"Unauthorized. Check your API credentials.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"Forbidden":{"description":"Forbidden. Verify domain or check permissions.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"NotFound":{"description":"Resource not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}},"schemas":{"ErrorResponse":{"type":"object","properties":{"success":{"type":"boolean"},"errors":{"type":"array","items":{"type":"string"}}}}}},"paths":{"/api/accounts/{account_id}/sending_domains/{sending_domain_id}":{"delete":{"summary":"Delete sending domain","description":"Remove a sending domain from your account","operationId":"deleteSendingDomain","tags":["domains"],"parameters":[{"$ref":"#/components/parameters/account_id"},{"$ref":"#/components/parameters/sending_domain_id"}],"responses":{"204":{"description":"Domain successfully deleted"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}}}}
```
## Update sending domain
> Update configuration settings for a sending domain.
```json
{"openapi":"3.1.0","info":{"title":"Email Sending","version":"2.0.0"},"tags":[{"name":"domains","description":"Configure and verify domains for email sending to ensure deliverability.\n"}],"servers":[{"description":"Mailtrap API","url":"https://mailtrap.io"}],"security":[{"HeaderAuth":[]},{"BearerAuth":[]}],"components":{"securitySchemes":{"HeaderAuth":{"type":"apiKey","description":"API token in Api-Token header","in":"header","name":"Api-Token"},"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer token authentication"}},"parameters":{"account_id":{"name":"account_id","in":"path","required":true,"description":"Account ID","schema":{"type":"integer"}},"sending_domain_id":{"name":"sending_domain_id","in":"path","required":true,"description":"Sending domain ID","schema":{"type":"integer"}}},"schemas":{"UpdateSendingDomainRequest":{"type":"object","properties":{"open_tracking_enabled":{"type":"boolean","description":"Enable open tracking for emails sent from this domain"},"click_tracking_enabled":{"type":"boolean","description":"Enable click tracking for links in emails sent from this domain"},"auto_unsubscribe_link_enabled":{"type":"boolean","description":"Automatically add an unsubscribe link to emails sent from this domain"}}},"SendingDomain":{"type":"object","properties":{"id":{"type":"integer"},"domain_name":{"type":"string"},"demo":{"type":"boolean"},"compliance_status":{"type":"string","description":"Indicates the compliance verification status of the sending domain.\nThe domain must reach `compliant` status before you can send emails\nin production.\n\n- `demo` - A demo domain provided by Mailtrap. Can only send emails to the account owner.\n- `demo_exhausted` - A demo domain that has used up its sending allowance. Cannot send emails.\n- `unverified_dns` - Domain DNS records have not been verified yet. Open your domain on the [Sending Domains](https://mailtrap.io/domains) page and follow the [Sending Domain Setup](https://docs.mailtrap.io/email-api-smtp/setup/sending-domain) guide.\n- `missing_company_info` - Account is missing required company information. Go to [Company Information](https://mailtrap.io/settings/account?current_tab=company_information) and fill in the required details.\n- `under_review` - Domain is undergoing automatic compliance review. No action needed — typically completes within 2 minutes.\n- `awaiting_questionnaire` - Automatic review required additional information. Open your domain on the [Sending Domains](https://mailtrap.io/domains) page and fill in the compliance questionnaire.\n- `awaiting_card_verification` - Compliance questionnaire was submitted but credit card identity verification is still needed. Open your domain on the [Sending Domains](https://mailtrap.io/domains) page and enter card details. The charged amount is refunded immediately and the card is not stored.\n- `non_compliant` - Domain did not pass compliance checks. Sending is not allowed. Contact [Mailtrap Support](mailto:support@mailtrap.io) for details and next steps.\n- `compliant` - Domain has passed all compliance checks and is ready to send emails.\n- `suspended` - Domain sending has been suspended. Contact [Mailtrap Support](mailto:support@mailtrap.io) to resolve the issue.\n","enum":["demo","demo_exhausted","unverified_dns","missing_company_info","under_review","awaiting_questionnaire","awaiting_card_verification","non_compliant","compliant","suspended"]},"dns_verified":{"type":"boolean"},"dns_verified_at":{"type":["string","null"]},"dns_records":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"domain":{"type":"string"},"name":{"type":"string"},"status":{"type":"string","enum":["pass","fail","unchecked","missing","softfail","network_error"]},"type":{"type":"string"},"value":{"type":"string"}}}},"open_tracking_enabled":{"type":"boolean"},"click_tracking_enabled":{"type":"boolean"},"auto_unsubscribe_link_enabled":{"type":"boolean"},"custom_domain_tracking_enabled":{"type":"boolean"},"health_alerts_enabled":{"type":"boolean"},"critical_alerts_enabled":{"type":"boolean"},"alert_recipient_email":{"type":["string","null"]},"permissions":{"type":"object","properties":{"can_read":{"type":"boolean"},"can_update":{"type":"boolean"},"can_destroy":{"type":"boolean"}}}}},"ErrorResponse":{"type":"object","properties":{"success":{"type":"boolean"},"errors":{"type":"array","items":{"type":"string"}}}},"UnprocessableEntity":{"type":"object","properties":{"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}}}}},"responses":{"SendingDomainResponse":{"description":"Sending domain details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendingDomain"}}}},"Unauthorized":{"description":"Unauthorized. Check your API credentials.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"Forbidden":{"description":"Forbidden. Verify domain or check permissions.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"NotFound":{"description":"Resource not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"UnprocessableEntity":{"description":"Validation errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"}}}}}},"paths":{"/api/accounts/{account_id}/sending_domains/{sending_domain_id}":{"patch":{"summary":"Update sending domain","description":"Update configuration settings for a sending domain.\n","operationId":"updateSendingDomain","tags":["domains"],"parameters":[{"$ref":"#/components/parameters/account_id"},{"$ref":"#/components/parameters/sending_domain_id"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["sending_domain"],"properties":{"sending_domain":{"$ref":"#/components/schemas/UpdateSendingDomainRequest"}}}}}},"responses":{"200":{"$ref":"#/components/responses/SendingDomainResponse"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/UnprocessableEntity"}}}}}}
```
## Send setup instructions
> Email DNS configuration instructions for the sending domain
```json
{"openapi":"3.1.0","info":{"title":"Email Sending","version":"2.0.0"},"tags":[{"name":"domains","description":"Configure and verify domains for email sending to ensure deliverability.\n"}],"servers":[{"description":"Mailtrap API","url":"https://mailtrap.io"}],"security":[{"HeaderAuth":[]},{"BearerAuth":[]}],"components":{"securitySchemes":{"HeaderAuth":{"type":"apiKey","description":"API token in Api-Token header","in":"header","name":"Api-Token"},"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer token authentication"}},"parameters":{"account_id":{"name":"account_id","in":"path","required":true,"description":"Account ID","schema":{"type":"integer"}},"sending_domain_id":{"name":"sending_domain_id","in":"path","required":true,"description":"Sending domain ID","schema":{"type":"integer"}}},"responses":{"Unauthorized":{"description":"Unauthorized. Check your API credentials.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"Forbidden":{"description":"Forbidden. Verify domain or check permissions.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"NotFound":{"description":"Resource not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"UnprocessableEntity":{"description":"Validation errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"}}}}},"schemas":{"ErrorResponse":{"type":"object","properties":{"success":{"type":"boolean"},"errors":{"type":"array","items":{"type":"string"}}}},"UnprocessableEntity":{"type":"object","properties":{"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}}}}}},"paths":{"/api/accounts/{account_id}/sending_domains/{sending_domain_id}/send_setup_instructions":{"post":{"summary":"Send setup instructions","description":"Email DNS configuration instructions for the sending domain","operationId":"sendSendingDomainSetupInstructions","tags":["domains"],"parameters":[{"$ref":"#/components/parameters/account_id"},{"$ref":"#/components/parameters/sending_domain_id"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["email"],"properties":{"email":{"type":"string","format":"email","description":"Email address to receive setup instructions"}}}}}},"responses":{"204":{"description":"Instructions sent successfully"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/UnprocessableEntity"}}}}}}
```
## Get company info
> Get company information associated with a sending domain / account.
```json
{"openapi":"3.1.0","info":{"title":"Email Sending","version":"2.0.0"},"tags":[{"name":"domains","description":"Configure and verify domains for email sending to ensure deliverability.\n"}],"servers":[{"description":"Mailtrap API","url":"https://mailtrap.io"}],"security":[{"HeaderAuth":[]},{"BearerAuth":[]}],"components":{"securitySchemes":{"HeaderAuth":{"type":"apiKey","description":"API token in Api-Token header","in":"header","name":"Api-Token"},"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer token authentication"}},"parameters":{"account_id":{"name":"account_id","in":"path","required":true,"description":"Account ID","schema":{"type":"integer"}},"sending_domain_id":{"name":"sending_domain_id","in":"path","required":true,"description":"Sending domain ID","schema":{"type":"integer"}}},"responses":{"CompanyInfoResponse":{"description":"Company information","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/CompanyInfo"}}}}}},"Unauthorized":{"description":"Unauthorized. Check your API credentials.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"Forbidden":{"description":"Forbidden. Verify domain or check permissions.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"NotFound":{"description":"Resource not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}},"schemas":{"CompanyInfo":{"type":"object","properties":{"name":{"type":["string","null"],"description":"Company or individual name"},"address":{"type":["string","null"],"description":"Street address"},"city":{"type":["string","null"],"description":"City"},"country":{"type":["string","null"],"description":"Country"},"phone":{"type":["string","null"],"description":"Phone number"},"zip_code":{"type":["string","null"],"description":"ZIP or postal code"},"privacy_policy_url":{"type":["string","null"],"format":"uri","description":"URL to the privacy policy page"},"terms_of_service_url":{"type":["string","null"],"format":"uri","description":"URL to the terms of service page"},"website_url":{"type":["string","null"],"format":"uri","description":"Company website URL or LinkedIn / personal website"},"info_level":{"type":"string","enum":["business","individual"],"description":"Whether the sender is a business or individual"}}},"ErrorResponse":{"type":"object","properties":{"success":{"type":"boolean"},"errors":{"type":"array","items":{"type":"string"}}}}}},"paths":{"/api/accounts/{account_id}/sending_domains/{sending_domain_id}/company_info":{"get":{"summary":"Get company info","description":"Get company information associated with a sending domain / account.\n","operationId":"getSendingDomainCompanyInfo","tags":["domains"],"parameters":[{"$ref":"#/components/parameters/account_id"},{"$ref":"#/components/parameters/sending_domain_id"}],"responses":{"200":{"$ref":"#/components/responses/CompanyInfoResponse"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}}}}
```
## Create company info
> Create company information for a sending domain / account.\
> Company info is required for domain compliance verification.
```json
{"openapi":"3.1.0","info":{"title":"Email Sending","version":"2.0.0"},"tags":[{"name":"domains","description":"Configure and verify domains for email sending to ensure deliverability.\n"}],"servers":[{"description":"Mailtrap API","url":"https://mailtrap.io"}],"security":[{"HeaderAuth":[]},{"BearerAuth":[]}],"components":{"securitySchemes":{"HeaderAuth":{"type":"apiKey","description":"API token in Api-Token header","in":"header","name":"Api-Token"},"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer token authentication"}},"parameters":{"account_id":{"name":"account_id","in":"path","required":true,"description":"Account ID","schema":{"type":"integer"}},"sending_domain_id":{"name":"sending_domain_id","in":"path","required":true,"description":"Sending domain ID","schema":{"type":"integer"}}},"schemas":{"CompanyInfoRequest":{"type":"object","required":["name","address","city","country","zip_code","website_url"],"properties":{"name":{"type":"string","description":"Company or individual name"},"address":{"type":"string","description":"Street address"},"city":{"type":"string","description":"City"},"country":{"type":"string","description":"Country"},"phone":{"type":"string","description":"Phone number"},"zip_code":{"type":"string","description":"ZIP or postal code"},"privacy_policy_url":{"type":"string","format":"uri","description":"URL to the privacy policy page"},"terms_of_service_url":{"type":"string","format":"uri","description":"URL to the terms of service page"},"website_url":{"type":"string","format":"uri","description":"Company website URL"},"info_level":{"type":"string","enum":["business","individual"],"description":"Whether the sender is a business or individual"}}},"CompanyInfo":{"type":"object","properties":{"name":{"type":["string","null"],"description":"Company or individual name"},"address":{"type":["string","null"],"description":"Street address"},"city":{"type":["string","null"],"description":"City"},"country":{"type":["string","null"],"description":"Country"},"phone":{"type":["string","null"],"description":"Phone number"},"zip_code":{"type":["string","null"],"description":"ZIP or postal code"},"privacy_policy_url":{"type":["string","null"],"format":"uri","description":"URL to the privacy policy page"},"terms_of_service_url":{"type":["string","null"],"format":"uri","description":"URL to the terms of service page"},"website_url":{"type":["string","null"],"format":"uri","description":"Company website URL or LinkedIn / personal website"},"info_level":{"type":"string","enum":["business","individual"],"description":"Whether the sender is a business or individual"}}},"ErrorResponse":{"type":"object","properties":{"success":{"type":"boolean"},"errors":{"type":"array","items":{"type":"string"}}}},"UnprocessableEntity":{"type":"object","properties":{"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}}}}},"responses":{"CompanyInfoResponse":{"description":"Company information","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/CompanyInfo"}}}}}},"Unauthorized":{"description":"Unauthorized. Check your API credentials.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"Forbidden":{"description":"Forbidden. Verify domain or check permissions.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"NotFound":{"description":"Resource not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"UnprocessableEntity":{"description":"Validation errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"}}}}}},"paths":{"/api/accounts/{account_id}/sending_domains/{sending_domain_id}/company_info":{"post":{"summary":"Create company info","description":"Create company information for a sending domain / account.\nCompany info is required for domain compliance verification.\n","operationId":"createSendingDomainCompanyInfo","tags":["domains"],"parameters":[{"$ref":"#/components/parameters/account_id"},{"$ref":"#/components/parameters/sending_domain_id"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["company_info"],"properties":{"company_info":{"$ref":"#/components/schemas/CompanyInfoRequest"}}}}}},"responses":{"200":{"$ref":"#/components/responses/CompanyInfoResponse"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/UnprocessableEntity"}}}}}}
```
## Update company info
> Update company information for a sending domain / account. All fields are optional;\
> only the fields provided in the request will be updated.
```json
{"openapi":"3.1.0","info":{"title":"Email Sending","version":"2.0.0"},"tags":[{"name":"domains","description":"Configure and verify domains for email sending to ensure deliverability.\n"}],"servers":[{"description":"Mailtrap API","url":"https://mailtrap.io"}],"security":[{"HeaderAuth":[]},{"BearerAuth":[]}],"components":{"securitySchemes":{"HeaderAuth":{"type":"apiKey","description":"API token in Api-Token header","in":"header","name":"Api-Token"},"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer token authentication"}},"parameters":{"account_id":{"name":"account_id","in":"path","required":true,"description":"Account ID","schema":{"type":"integer"}},"sending_domain_id":{"name":"sending_domain_id","in":"path","required":true,"description":"Sending domain ID","schema":{"type":"integer"}}},"schemas":{"CompanyInfoUpdateRequest":{"type":"object","description":"All fields are optional. Only the fields provided in the request will be updated.\n","properties":{"name":{"type":"string","description":"Company or individual name"},"address":{"type":"string","description":"Street address"},"city":{"type":"string","description":"City"},"country":{"type":"string","description":"Country"},"phone":{"type":"string","description":"Phone number"},"zip_code":{"type":"string","description":"ZIP or postal code"},"privacy_policy_url":{"type":"string","format":"uri","description":"URL to the privacy policy page"},"terms_of_service_url":{"type":"string","format":"uri","description":"URL to the terms of service page"},"website_url":{"type":"string","format":"uri","description":"Company website URL"},"info_level":{"type":"string","enum":["business","individual"],"description":"Whether the sender is a business or individual"}}},"CompanyInfo":{"type":"object","properties":{"name":{"type":["string","null"],"description":"Company or individual name"},"address":{"type":["string","null"],"description":"Street address"},"city":{"type":["string","null"],"description":"City"},"country":{"type":["string","null"],"description":"Country"},"phone":{"type":["string","null"],"description":"Phone number"},"zip_code":{"type":["string","null"],"description":"ZIP or postal code"},"privacy_policy_url":{"type":["string","null"],"format":"uri","description":"URL to the privacy policy page"},"terms_of_service_url":{"type":["string","null"],"format":"uri","description":"URL to the terms of service page"},"website_url":{"type":["string","null"],"format":"uri","description":"Company website URL or LinkedIn / personal website"},"info_level":{"type":"string","enum":["business","individual"],"description":"Whether the sender is a business or individual"}}},"ErrorResponse":{"type":"object","properties":{"success":{"type":"boolean"},"errors":{"type":"array","items":{"type":"string"}}}},"UnprocessableEntity":{"type":"object","properties":{"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}}}}},"responses":{"CompanyInfoResponse":{"description":"Company information","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/CompanyInfo"}}}}}},"Unauthorized":{"description":"Unauthorized. Check your API credentials.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"Forbidden":{"description":"Forbidden. Verify domain or check permissions.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"NotFound":{"description":"Resource not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"UnprocessableEntity":{"description":"Validation errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"}}}}}},"paths":{"/api/accounts/{account_id}/sending_domains/{sending_domain_id}/company_info":{"patch":{"summary":"Update company info","description":"Update company information for a sending domain / account. All fields are optional;\nonly the fields provided in the request will be updated.\n","operationId":"updateSendingDomainCompanyInfo","tags":["domains"],"parameters":[{"$ref":"#/components/parameters/account_id"},{"$ref":"#/components/parameters/sending_domain_id"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["company_info"],"properties":{"company_info":{"$ref":"#/components/schemas/CompanyInfoUpdateRequest"}}}}}},"responses":{"200":{"$ref":"#/components/responses/CompanyInfoResponse"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/UnprocessableEntity"}}}}}}
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.mailtrap.io/developers/email-sending/sending-domains.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.