Add Receiving Domain

POST

api

receiving-domains

curl --request POST \
  --url https://api.sequenzy.com/api/v1/receiving-domains \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "domain": "<string>"
}
'

import requests

url = "https://api.sequenzy.com/api/v1/receiving-domains"

payload = { "domain": "<string>" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({domain: '<string>'})
};

fetch('https://api.sequenzy.com/api/v1/receiving-domains', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sequenzy.com/api/v1/receiving-domains",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'domain' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sequenzy.com/api/v1/receiving-domains"

	payload := strings.NewReader("{\n  \"domain\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.sequenzy.com/api/v1/receiving-domains")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"domain\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.sequenzy.com/api/v1/receiving-domains")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"domain\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "created": true,
  "receivingDomain": {
    "id": "k3x9rd2m8q1pz7w4v6n0b5c",
    "domain": "support.acme.com",
    "status": "pending",
    "records": [
      {
        "type": "MX",
        "name": "support.acme.com",
        "value": "inbound-smtp.us-east-1.amazonaws.com",
        "priority": 10,
        "status": "pending"
      },
      {
        "type": "TXT",
        "name": "_amazonses.support.acme.com",
        "value": "pmBGN/7MjnfhTKUZ06Enqq1PeGUaOkw8lGhcfwefcHU=",
        "status": "pending"
      }
    ],
    "error": null,
    "claimExpiresAt": "2026-10-17T09:00:00.000Z",
    "verifiedAt": null,
    "lastCheckedAt": "2026-10-10T09:00:00.000Z",
    "createdAt": "2026-10-10T09:00:00.000Z"
  }
}

{
  "error": "Enter a domain you own, such as acme.com or support.acme.com.",
  "code": "invalid_domain"
}

{
  "error": "gmail.com belongs to an email provider. Use a domain you own.",
  "code": "reserved_domain"
}

{
  "error": "You have view-only access to this company. Contact the owner to request edit permissions."
}

{
  "error": "support.acme.com is already used by another workspace.",
  "code": "domain_taken"
}

{
  "error": "acme.com already receives email through Google Workspace, so we can't receive it here without breaking that mailbox. Use a subdomain such as support.acme.com, or another domain you own.",
  "code": "domain_has_mailbox"
}

{
  "error": "A workspace has one receiving domain. Remove it first to use a different one.",
  "code": "limit_reached"
}

{
  "error": "We couldn't check where acme.com receives email right now. Try again in a minute.",
  "code": "dns_check_failed"
}

Add your workspace’s receiving domain, a domain or subdomain whose mail should reach your Inbox such as support.acme.com, and get the DNS records to publish. Once the records are found, every address on the domain lands in your Inbox, and replies to emails from all your sending domains come back to reply addresses on it, the same way your tracking domain serves every sending domain. Until then, replies keep using inbound.sequenzy.com. The first verification also turns Inbox on. A workspace has one receiving domain. To use a different one, remove the current one first.

Mail for a domain goes wherever its MX records point, for every address at once. If the domain already receives email somewhere else, such as Google Workspace, Microsoft 365 or Cloudflare Email Routing, the request is refused with domain_has_mailbox, because receiving it here would break that mailbox. Use a subdomain such as support.acme.com instead, which leaves your existing mailboxes on acme.com untouched. If the MX lookup gets no answer, the request fails with 503 and dns_check_failed; try again in a minute.

Publish the returned records with your DNS provider. The MX record is always listed. A TXT record at _amazonses.<domain> is listed too when Amazon SES needs proof that you own the name. Sequenzy then checks the domain automatically, or you can check right away with Verify Receiving Domain. When the name is also one of your sending domains, no TXT record is listed: the sending domain’s own Amazon SES verification covers it, so receiving starts once that sending domain is verified. If error says the domain can’t receive because of how it is set up for sending, receive on a subdomain such as support.acme.com instead. A new name is reserved for your workspace for 7 days (claimExpiresAt). If the records are not found by then, another workspace may add the name, which removes it from yours. Adding a name this workspace already has returns it unchanged with created: false and HTTP 200, without checking its MX records again, so retries are safe. Adding your first receiving domain also sets the company’s replyTrackingDomainMode to custom, so reply addresses use your receiving domain once it is verified. Requires the websites:write scope and owner or admin access. CLI: sequenzy receiving-domains add support.acme.com. MCP: add_receiving_domain.

Request

string

required

A domain or subdomain you own, such as acme.com or support.acme.com. Case and a trailing dot are ignored. Sequenzy’s own domains and email providers’ domains such as gmail.com can’t be added.

curl -X POST "https://api.sequenzy.com/api/v1/receiving-domains" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain": "support.acme.com"}'

Response fields

boolean

true when the domain was added (HTTP 201), false when this workspace already had it (HTTP 200).

object

The receiving domain, with the fields described in Get Receiving Domain.

Responses

{
  "success": true,
  "created": true,
  "receivingDomain": {
    "id": "k3x9rd2m8q1pz7w4v6n0b5c",
    "domain": "support.acme.com",
    "status": "pending",
    "records": [
      {
        "type": "MX",
        "name": "support.acme.com",
        "value": "inbound-smtp.us-east-1.amazonaws.com",
        "priority": 10,
        "status": "pending"
      },
      {
        "type": "TXT",
        "name": "_amazonses.support.acme.com",
        "value": "pmBGN/7MjnfhTKUZ06Enqq1PeGUaOkw8lGhcfwefcHU=",
        "status": "pending"
      }
    ],
    "error": null,
    "claimExpiresAt": "2026-10-17T09:00:00.000Z",
    "verifiedAt": null,
    "lastCheckedAt": "2026-10-10T09:00:00.000Z",
    "createdAt": "2026-10-10T09:00:00.000Z"
  }
}

{
  "error": "Enter a domain you own, such as acme.com or support.acme.com.",
  "code": "invalid_domain"
}

{
  "error": "gmail.com belongs to an email provider. Use a domain you own.",
  "code": "reserved_domain"
}

{
  "error": "You have view-only access to this company. Contact the owner to request edit permissions."
}

{
  "error": "support.acme.com is already used by another workspace.",
  "code": "domain_taken"
}

{
  "error": "acme.com already receives email through Google Workspace, so we can't receive it here without breaking that mailbox. Use a subdomain such as support.acme.com, or another domain you own.",
  "code": "domain_has_mailbox"
}

{
  "error": "A workspace has one receiving domain. Remove it first to use a different one.",
  "code": "limit_reached"
}

{
  "error": "We couldn't check where acme.com receives email right now. Try again in a minute.",
  "code": "dns_check_failed"
}

A name is domain_taken, always with the same message, when another workspace receives on it, receives or sends on a parent domain (for example acme.com for support.acme.com), or still receives on it through a sending domain set up before receiving domains. Another workspace’s claim that never verified stops counting after 7 days.

Add Receiving Domain

curl --request POST \
  --url https://api.sequenzy.com/api/v1/receiving-domains \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "domain": "<string>"
}
'

import requests

url = "https://api.sequenzy.com/api/v1/receiving-domains"

payload = { "domain": "<string>" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({domain: '<string>'})
};

fetch('https://api.sequenzy.com/api/v1/receiving-domains', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sequenzy.com/api/v1/receiving-domains",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'domain' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sequenzy.com/api/v1/receiving-domains"

	payload := strings.NewReader("{\n  \"domain\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.sequenzy.com/api/v1/receiving-domains")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"domain\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.sequenzy.com/api/v1/receiving-domains")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"domain\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "created": true,
  "receivingDomain": {
    "id": "k3x9rd2m8q1pz7w4v6n0b5c",
    "domain": "support.acme.com",
    "status": "pending",
    "records": [
      {
        "type": "MX",
        "name": "support.acme.com",
        "value": "inbound-smtp.us-east-1.amazonaws.com",
        "priority": 10,
        "status": "pending"
      },
      {
        "type": "TXT",
        "name": "_amazonses.support.acme.com",
        "value": "pmBGN/7MjnfhTKUZ06Enqq1PeGUaOkw8lGhcfwefcHU=",
        "status": "pending"
      }
    ],
    "error": null,
    "claimExpiresAt": "2026-10-17T09:00:00.000Z",
    "verifiedAt": null,
    "lastCheckedAt": "2026-10-10T09:00:00.000Z",
    "createdAt": "2026-10-10T09:00:00.000Z"
  }
}

{
  "error": "Enter a domain you own, such as acme.com or support.acme.com.",
  "code": "invalid_domain"
}

{
  "error": "gmail.com belongs to an email provider. Use a domain you own.",
  "code": "reserved_domain"
}

{
  "error": "You have view-only access to this company. Contact the owner to request edit permissions."
}

{
  "error": "support.acme.com is already used by another workspace.",
  "code": "domain_taken"
}

{
  "error": "acme.com already receives email through Google Workspace, so we can't receive it here without breaking that mailbox. Use a subdomain such as support.acme.com, or another domain you own.",
  "code": "domain_has_mailbox"
}

{
  "error": "A workspace has one receiving domain. Remove it first to use a different one.",
  "code": "limit_reached"
}

{
  "error": "We couldn't check where acme.com receives email right now. Try again in a minute.",
  "code": "dns_check_failed"
}

​Request

​Response fields

​Responses

Request

Response fields

Responses