Create a domain
curl --request POST \
--url https://inboundr.net/api/v1/domains \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"domain": "<string>"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({domain: '<string>'})
};
fetch('https://inboundr.net/api/v1/domains', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://inboundr.net/api/v1/domains"
payload = { "domain": "<string>" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://inboundr.net/api/v1/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;
}{
"id": "dom_123",
"domain": "yourdomain.com",
"status": "pending",
"dkimTokens": ["token1", "token2", "token3"],
"dnsRecords": [
{ "type": "MX", "name": "yourdomain.com", "value": "…", "priority": 10 },
{ "type": "CNAME", "name": "token1._domainkey.yourdomain.com", "value": "…" }
],
"createdAt": "2026-07-20T10:00:00.000Z"
}
Domains
Create a domain
Register a domain and get the DNS records to publish.
POST
/
api
/
v1
/
domains
Create a domain
curl --request POST \
--url https://inboundr.net/api/v1/domains \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"domain": "<string>"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({domain: '<string>'})
};
fetch('https://inboundr.net/api/v1/domains', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://inboundr.net/api/v1/domains"
payload = { "domain": "<string>" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://inboundr.net/api/v1/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;
}{
"id": "dom_123",
"domain": "yourdomain.com",
"status": "pending",
"dkimTokens": ["token1", "token2", "token3"],
"dnsRecords": [
{ "type": "MX", "name": "yourdomain.com", "value": "…", "priority": 10 },
{ "type": "CNAME", "name": "token1._domainkey.yourdomain.com", "value": "…" }
],
"createdAt": "2026-07-20T10:00:00.000Z"
}
Registers a domain and returns the MX and DKIM records to add at your DNS
host. The domain starts
pending and verifies automatically once the records
are observed. See Domains.
string
required
The domain name, e.g.
yourdomain.com. Lowercased; must be a valid public
domain.{
"id": "dom_123",
"domain": "yourdomain.com",
"status": "pending",
"dkimTokens": ["token1", "token2", "token3"],
"dnsRecords": [
{ "type": "MX", "name": "yourdomain.com", "value": "…", "priority": 10 },
{ "type": "CNAME", "name": "token1._domainkey.yourdomain.com", "value": "…" }
],
"createdAt": "2026-07-20T10:00:00.000Z"
}
array
Every record to publish. The domain won’t verify until they’re all live.
Returns
409 Conflict if the domain is already registered.⌘I