SUsupersend
Domains

Connect Domain

Changed on

Connects a domain the organization already owns (registered anywhere outside SuperSend) to a team, so inboxes can be bought on it. Free. Nothing changes at the registrar yet: the domain gets nameservers to set only once inboxes on it are paid for (list it in POST /setup/inbox-checkout), and POST /domains/{id}/verify then shows them.

Use a domain only for outreach: changing its nameservers later moves all of its DNS (website, other email) to SuperSend.

Connecting a domain that's already in the organization returns it with already_connected: true (200) instead of failing.

post/domains/connect

Request

Request body

domainstring required

Bare domain name; a URL or leading www. is stripped.

team_idstring uuid

Team to connect it to. Defaults to the caller's default team.

Example request

{
  "domain": "tryacme.com"
}

Response

Domain was already in the organization (already_connected: true)

successboolean
request_idstring

Example response

{
  "success": true,
  "request_id": "req_abc123def456",
  "data": {
    "object": "domain_setup"
  }
}

Changes