Verify Receiving Domain

POST

api

receiving-domains

{domain}

verify

Verify Receiving Domain

curl --request POST \
  --url https://api.sequenzy.com/api/v1/receiving-domains/{domain}/verify \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.sequenzy.com/api/v1/receiving-domains/{domain}/verify"

headers = {"Authorization": "Bearer <token>"}

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

print(response.text)

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.sequenzy.com/api/v1/receiving-domains/{domain}/verify', 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/{domain}/verify",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.sequenzy.com/api/v1/receiving-domains/{domain}/verify"

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

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "success": 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": "verified"
      },
      {
        "type": "TXT",
        "name": "_amazonses.support.acme.com",
        "value": "pmBGN/7MjnfhTKUZ06Enqq1PeGUaOkw8lGhcfwefcHU=",
        "status": "pending"
      }
    ],
    "error": "Add the TXT record so Amazon SES can confirm you own support.acme.com.",
    "claimExpiresAt": "2026-10-17T09:00:00.000Z",
    "verifiedAt": null,
    "lastCheckedAt": "2026-10-10T09:10:00.000Z",
    "createdAt": "2026-10-10T09:00:00.000Z"
  }
}

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

{
  "error": "Receiving domain not found.",
  "code": "not_found"
}

Check a receiving domain’s DNS records and Amazon SES setup now instead of waiting for the next automatic check, and get the result. Call it after you publish or change the records. The request succeeds whatever the outcome; read status and error for the result. When the MX record points only to Sequenzy and Amazon SES confirms you own the name, the domain becomes verified. If Sequenzy can’t finish setting up receiving on its side, the domain stays pending (or becomes failed if it was verified before) with an error, and Sequenzy keeps retrying. When DNS or Amazon SES gives no answer, the status is left unchanged and the next automatic check runs 15 minutes later. The first time a receiving domain you added with Add Receiving Domain becomes verified, Inbox turns on for your workspace (replyTrackingEnabled on the company becomes true), and replies to emails from all your sending domains start using it. Later checks leave the Inbox setting as you set it. Receiving domains moved from an older reply setup, or added by naming a sending domain in Update Inbox Address, never change the Inbox setting when they verify. Requires the websites:write scope and owner or admin access. CLI: sequenzy receiving-domains verify support.acme.com. MCP: verify_receiving_domain.

Request

string

required

The receiving domain’s name, such as support.acme.com, or its id.

curl -X POST "https://api.sequenzy.com/api/v1/receiving-domains/support.acme.com/verify" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response fields

object

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

Responses

{
  "success": 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": "verified"
      },
      {
        "type": "TXT",
        "name": "_amazonses.support.acme.com",
        "value": "pmBGN/7MjnfhTKUZ06Enqq1PeGUaOkw8lGhcfwefcHU=",
        "status": "pending"
      }
    ],
    "error": "Add the TXT record so Amazon SES can confirm you own support.acme.com.",
    "claimExpiresAt": "2026-10-17T09:00:00.000Z",
    "verifiedAt": null,
    "lastCheckedAt": "2026-10-10T09:10:00.000Z",
    "createdAt": "2026-10-10T09:00:00.000Z"
  }
}

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

{
  "error": "Receiving domain not found.",
  "code": "not_found"
}

Verify Receiving Domain

curl --request POST \
  --url https://api.sequenzy.com/api/v1/receiving-domains/{domain}/verify \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.sequenzy.com/api/v1/receiving-domains/{domain}/verify"

headers = {"Authorization": "Bearer <token>"}

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

print(response.text)

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.sequenzy.com/api/v1/receiving-domains/{domain}/verify', 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/{domain}/verify",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.sequenzy.com/api/v1/receiving-domains/{domain}/verify"

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

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "success": 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": "verified"
      },
      {
        "type": "TXT",
        "name": "_amazonses.support.acme.com",
        "value": "pmBGN/7MjnfhTKUZ06Enqq1PeGUaOkw8lGhcfwefcHU=",
        "status": "pending"
      }
    ],
    "error": "Add the TXT record so Amazon SES can confirm you own support.acme.com.",
    "claimExpiresAt": "2026-10-17T09:00:00.000Z",
    "verifiedAt": null,
    "lastCheckedAt": "2026-10-10T09:10:00.000Z",
    "createdAt": "2026-10-10T09:00:00.000Z"
  }
}

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

{
  "error": "Receiving domain not found.",
  "code": "not_found"
}

​Request

​Response fields

​Responses

Request

Response fields

Responses