---
title: "Add a sender domain"
method: POST
path: "/domain/add"
tags: ["SENDER DOMAINS"]
---

# Add a sender domain

`POST /domain/add`

Add a sender domain to your account. Note that you must own any domains you wish to include in this list, as you will be required to verify and authenticate the emails sent via that domain. Find full details in the Sender Domains Guide.

## Request body

- object
  - `domain` string, required — Domain to add as a sender domain
  - `tracking_subdomain` string — An optional subdomain used for click or open tracking and unsubscribe links
  - `returnpath_subdomain` string — An optional subdomain to use as a return-path subdomain
  - `auto_verify` boolean — If true, verify the domain now removing the need to call the 'domain/verify' endpoint or wait for the periodic verification every 7 minutes.<br> <br> <strong>Note:</strong> In order to successfully complete the verification, the 'tracking_subdomain' and 'returnpath_subdomain' must be configured in the domain DNS and propagated.
  - `requisition_ssl` boolean — If true, requisition an SSL certificate for the tracking domain once verification is complete
  - `subaccount_id` string — If you wish to make this API call on behalf of a subaccount then include its unique ID here
  - `subaccount_access` object — Allow subaccounts to send from verified sender domains on the master account
    - `subaccounts` unknown[] — A list of subaccount_ids to be given access. ID's can be found by querying <code>/subaccounts/search</code>
      - unknown
    - `future_subaccounts` boolean — If set to true, will automatically add any new subaccounts to the access list

## Response `200`

Domain added

- object
  - `request_id` string, required
  - `data` object, required
    - `domains` object[], required
      - `domain` object
        - `dkim_value` string, required
        - `domain` string, required
        - `suffix` string, required
        - `rpath_selector` string
        - `rpath_status` string, required
        - `rpath_verified` boolean
        - `rpath_value` string, required
        - `dkim_status` string, required
        - `dkim_verified` boolean
        - `subdomain` unknown, required
        - `fulldomain` string, required
        - `dkim_selector` string, required
        - `setup_link` string, required — A URL that can be used to automate DNS additions
      - `trackers` object[]
        - `cname_value` string, required
        - `cname_status` string, required
        - `cname_verified` boolean
        - `domain` string
        - `suffix` string
        - `subdomain` string
        - `enabled` boolean
        - `fulldomain` string
      - `subaccount_access` object
        - `subaccounts` unknown[] — A list of subaccount IDs that were given access the sender domain.
          - unknown
        - `future_subaccounts` boolean — If true, any new subaccounts added will automatically be given access.

## Other responses

- `400` — 400

---

[API](https://skmtc.net/smtp2go/apis/smtp2go-api-v3-0-4.md) · [All operations](https://skmtc.net/smtp2go/apis/smtp2go-api-v3-0-4/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smtp2go/smtp2go-api-v3-0-4/revisions/1ba6b25eebb9/schema)