Languages: every operation supports cURL, Node.js (TypeScript), Python, Go, Ruby, and PHP. The first 15 operations on this page show all six languages; the remaining 27 show cURL and TypeScript — the two most-used.

Email API

Email endpoints exposed by the Devotel CPaaS API Base path: /api/v1/email Endpoint count: 42

title: “Worked email lifecycle samples” description: “Worked request and response samples for the email senders lifecycle: register a sender, verify the domain’s DNS records, run a test-send, manage suppressions, and validate recipients.”

Worked email lifecycle samples

Copy a request as written, substitute your own ids, and compare the response envelope. Errors follow Devotel Orbit’s { error, meta } envelope and carry a request_id in meta you quote when reporting. The sender chain: register a sender → publish the domain’s DNS records → run a test-send → keep suppressions clean.

1. Register a sender

POST /api/v1/email/senders

Request

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/email/senders" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
  "domain": "mail.acme.com",
  "default_from_email": "sales@acme.com",
  "default_from_name": "Acme Sales",
  "default_reply_to": "support@acme.com",
  "isDefault": true
}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/senders', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "domain": "mail.acme.com",
  "default_from_email": "sales@acme.com",
  "default_from_name": "Acme Sales",
  "default_reply_to": "support@acme.com",
  "isDefault": true
}),
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
headers["Content-Type"] = "application/json"
r = requests.post("https://api.orbit.devotel.io/api/v1/email/senders", headers=headers, json={
  "domain": "mail.acme.com",
  "default_from_email": "sales@acme.com",
  "default_from_name": "Acme Sales",
  "default_reply_to": "support@acme.com",
  "isDefault": true
})
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("POST", "https://api.orbit.devotel.io/api/v1/email/senders", bytes.NewBuffer([]byte(`{
  "domain": "mail.acme.com",
  "default_from_email": "sales@acme.com",
  "default_from_name": "Acme Sales",
  "default_reply_to": "support@acme.com",
  "isDefault": true
}`)))
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))
	req.Header.Set("Content-Type", "application/json")
	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/email/senders')
req = Net::HTTP::Post.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']
req['Content-Type'] = 'application/json'
req.body = {
  "domain": "mail.acme.com",
  "default_from_email": "sales@acme.com",
  "default_from_name": "Acme Sales",
  "default_reply_to": "support@acme.com",
  "isDefault": true
}.to_json
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/email/senders');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),
  'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, <<<JSON
{
  "domain": "mail.acme.com",
  "default_from_email": "sales@acme.com",
  "default_from_name": "Acme Sales",
  "default_reply_to": "support@acme.com",
  "isDefault": true
}
JSON);
echo curl_exec($ch);

{
  "data": {
    "id": "esend_9f3ab2d61c4a",
    "domain": "mail.acme.com",
    "default_from_email": "sales@acme.com",
    "default_from_name": "Acme Sales",
    "default_reply_to": "support@acme.com",
    "isDefault": true,
    "streamId": null
  },
  "meta": {
    "request_id": "req_send_reg",
    "timestamp": "2026-08-01T12:00:00.000Z"
  }
}

The domain is registered with the sending provider, which issues real SPF/DKIM records — publish them with your DNS provider, then verify with the DNS-status read below before the sender can send. Omit default_from_email to send as noreply@<domain>.

2. Update the sender’s defaults

PUT /api/v1/email/senders/{senderId}

Request

cURL

curl -X PUT "https://api.orbit.devotel.io/api/v1/email/senders/{senderId}" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
  "default_from_email": "offers@acme.com",
  "default_from_name": "Acme Offers",
  "default_reply_to": "support@acme.com"
}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/senders/{senderId}', {
  method: 'PUT',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "default_from_email": "offers@acme.com",
  "default_from_name": "Acme Offers",
  "default_reply_to": "support@acme.com"
}),
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
headers["Content-Type"] = "application/json"
r = requests.put("https://api.orbit.devotel.io/api/v1/email/senders/{senderId}", headers=headers, json={
  "default_from_email": "offers@acme.com",
  "default_from_name": "Acme Offers",
  "default_reply_to": "support@acme.com"
})
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("PUT", "https://api.orbit.devotel.io/api/v1/email/senders/{senderId}", bytes.NewBuffer([]byte(`{
  "default_from_email": "offers@acme.com",
  "default_from_name": "Acme Offers",
  "default_reply_to": "support@acme.com"
}`)))
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))
	req.Header.Set("Content-Type", "application/json")
	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/email/senders/{senderId}')
req = Net::HTTP::Put.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']
req['Content-Type'] = 'application/json'
req.body = {
  "default_from_email": "offers@acme.com",
  "default_from_name": "Acme Offers",
  "default_reply_to": "support@acme.com"
}.to_json
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/email/senders/{senderId}');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PUT');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),
  'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, <<<JSON
{
  "default_from_email": "offers@acme.com",
  "default_from_name": "Acme Offers",
  "default_reply_to": "support@acme.com"
}
JSON);
echo curl_exec($ch);

{
  "data": {
    "id": "esend_9f3ab2d61c4a",
    "domain": "mail.acme.com",
    "default_from_email": "offers@acme.com",
    "default_from_name": "Acme Offers",
    "default_reply_to": "support@acme.com",
    "isDefault": true,
    "streamId": null
  },
  "meta": {
    "request_id": "req_send_upd",
    "timestamp": "2026-08-01T12:05:00.000Z"
  }
}

PUT replaces the From/Reply-To defaults — pass every field you want to keep. Promoting back to default uses the dedicated endpoint below (flipping isDefault: false here is a no-op).

3. Promote a sender to the org default

POST /api/v1/email/senders/{senderId}/set-default

{
  "data": {
    "id": "esend_9f3ab2d61c4a",
    "domain": "mail.acme.com",
    "default_from_email": "offers@acme.com",
    "default_from_name": "Acme Offers",
    "default_reply_to": "support@acme.com",
    "isDefault": true,
    "streamId": null
  },
  "meta": {
    "request_id": "req_send_default",
    "timestamp": "2026-08-01T12:06:00.000Z"
  }
}

The compose dropdown fills with this sender first; the previous default is demoted. Deleting a sender (DELETE /api/v1/email/senders/{senderId}) removes it from the dropdown and accepts no body.

4. Check the domain’s DNS records

GET /api/v1/email/domains/{domainId}/dns-status

Request

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/email/domains/{domainId}/dns-status" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/domains/{domainId}/dns-status', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
r = requests.get("https://api.orbit.devotel.io/api/v1/email/domains/{domainId}/dns-status", headers=headers)
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.orbit.devotel.io/api/v1/email/domains/{domainId}/dns-status", nil)
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))

	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/email/domains/{domainId}/dns-status')
req = Net::HTTP::Get.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']


res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/email/domains/{domainId}/dns-status');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),

]);

echo curl_exec($ch);

{
  "data": {
    "domain": "acme.com",
    "punycode": "acme.com",
    "overallStatus": "valid",
    "checkedAt": "2026-08-01T12:15:00.000Z",
    "fromCache": false,
    "isDefault": false,
    "records": [
      {
        "kind": "spf",
        "status": "valid",
        "recordExpected": "v=spf1 include:_spf.send.devotel.io ~all",
        "recordActual": "v=spf1 include:_spf.send.devotel.io ~all",
        "issues": []
      },
      {
        "kind": "dkim",
        "selector": "resend",
        "status": "valid",
        "recordExpected": "k=rsa; p=MIGfMA0GCSqGSIb3DQEBAQUAA",
        "recordActual": "k=rsa; p=MIGfMA0GCSqGSIb3DQEBAQUAA",
        "issues": []
      },
      {
        "kind": "dmarc",
        "status": "valid",
        "recordExpected": "v=DMARC1",
        "recordActual": "v=DMARC1; p=none",
        "issues": []
      },
      {
        "kind": "mx",
        "status": "valid",
        "recordExpected": "9 inbound.devotel.io",
        "recordActual": "9 inbound.devotel.io",
        "issues": []
      }
    ]
  },
  "meta": {
    "request_id": "req_dns_status",
    "timestamp": "2026-08-01T12:15:00.000Z"
  }
}

Each record renders a traffic light (valid / warning / invalid / unknown); overallStatus is the worst of them. Compare recordExpected against recordActual to see what your DNS provider is missing. Pass ?refresh=true to re-verify at the provider, not just at DNS. GET /dns-history?days=30 returns the same id with an entries array of dated record snapshots so you can trace propagation.

5. Run a test-send and poll the result

POST /api/v1/email/domains/{domainId}/test-send

{
  "data": {
    "testId": "emailTestSend_53a1c0f9d2",
    "to": "emailTestSend_53a1c0f9d2@orbittest.devotel.io",
    "from": "noreply@orbit.devotel.io",
    "providerMessageId": "r_eml_4c2d1b8f9a",
    "status": "pending"
  },
  "meta": {
    "request_id": "req_test_send",
    "timestamp": "2026-08-01T12:17:00.000Z"
  }
}

Poll GET /api/v1/email/domains/{domainId}/test-send/{testId}/result with the returned testId:

{
  "data": {
    "testId": "emailTestSend_53a1c0f9d2",
    "domain": "acme.com",
    "status": "received",
    "spamScore": 0.4,
    "estimated": false,
    "authResults": {
      "spf": "pass",
      "dkim": "pass",
      "dmarc": "pass",
      "raw": ""
    },
    "verifierSummary": null,
    "placement": null,
    "headersRaw": null,
    "createdAt": "2026-08-01T12:17:00.000Z",
    "receivedAt": "2026-08-01T12:19:11.000Z"
  },
  "meta": {
    "request_id": "req_test_result",
    "timestamp": "2026-08-01T12:20:00.000Z"
  }
}

Until the proof lands the result endpoint returns 404 (retry — it usually settles within a minute). estimated: true means the spamScore is a provisional estimate from the domain’s DNS grid, not the measured receiver verdict. GET /inbox-placement?days=30 aggregates delivered proofs into an inbox/spam/promotions breakdown with an inboxRate percentage.

6. Validate recipient addresses

POST /api/v1/email/validate

Request

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/email/validate" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
  "email": "recipient@example.com"
}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/validate', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "email": "recipient@example.com"
}),
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
headers["Content-Type"] = "application/json"
r = requests.post("https://api.orbit.devotel.io/api/v1/email/validate", headers=headers, json={
  "email": "recipient@example.com"
})
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("POST", "https://api.orbit.devotel.io/api/v1/email/validate", bytes.NewBuffer([]byte(`{
  "email": "recipient@example.com"
}`)))
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))
	req.Header.Set("Content-Type", "application/json")
	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/email/validate')
req = Net::HTTP::Post.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']
req['Content-Type'] = 'application/json'
req.body = {
  "email": "recipient@example.com"
}.to_json
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/email/validate');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),
  'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, <<<JSON
{
  "email": "recipient@example.com"
}
JSON);
echo curl_exec($ch);

{
  "data": {
    "email": "recipient@example.com",
    "valid": true,
    "suggestion": null,
    "reason": "deliverable"
  },
  "meta": {
    "request_id": "req_val",
    "timestamp": "2026-08-01T12:12:00.000Z"
  }
}

Check addresses before a campaign or import. suggestion carries the corrected domain on mistyped common domains (e.g. gamil.com → gmail.com). For batch checks, POST /api/v1/email/validate/bulk: Request

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/email/validate/bulk" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
  "emails": [
    "alice@example.com",
    "bad.domain",
    "bob@example.com"
  ]
}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/validate/bulk', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "emails": [
    "alice@example.com",
    "bad.domain",
    "bob@example.com"
  ]
}),
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
headers["Content-Type"] = "application/json"
r = requests.post("https://api.orbit.devotel.io/api/v1/email/validate/bulk", headers=headers, json={
  "emails": [
    "alice@example.com",
    "bad.domain",
    "bob@example.com"
  ]
})
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("POST", "https://api.orbit.devotel.io/api/v1/email/validate/bulk", bytes.NewBuffer([]byte(`{
  "emails": [
    "alice@example.com",
    "bad.domain",
    "bob@example.com"
  ]
}`)))
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))
	req.Header.Set("Content-Type", "application/json")
	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/email/validate/bulk')
req = Net::HTTP::Post.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']
req['Content-Type'] = 'application/json'
req.body = {
  "emails": [
    "alice@example.com",
    "bad.domain",
    "bob@example.com"
  ]
}.to_json
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/email/validate/bulk');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),
  'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, <<<JSON
{
  "emails": [
    "alice@example.com",
    "bad.domain",
    "bob@example.com"
  ]
}
JSON);
echo curl_exec($ch);

{
  "data": {
    "total": 3,
    "valid": 2,
    "invalid": 1,
    "results": {
      "alice@example.com": {
        "valid": true,
        "reason": "deliverable"
      },
      "bad.domain": {
        "valid": false,
        "reason": "syntax_failure"
      }
    },
    "invalidAddresses": [
      "bad.domain"
    ]
  },
  "meta": {
    "request_id": "req_val_bulk",
    "timestamp": "2026-08-01T12:13:00.000Z"
  }
}

Each address reports deliverable, mailbox_full / undeliverable, mailbox_disabled, spamtrap, potential, invalid_mx, no_mx, or syntax_failure. The bulk form returns a results map plus the invalidAddresses list so you don’t have to cross-check every entry.

7. Manage the suppression list

POST /api/v1/email/suppressions

Request

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/email/suppressions" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
  "email": "customer@example.com",
  "reason": "manual"
}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/suppressions', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "email": "customer@example.com",
  "reason": "manual"
}),
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
headers["Content-Type"] = "application/json"
r = requests.post("https://api.orbit.devotel.io/api/v1/email/suppressions", headers=headers, json={
  "email": "customer@example.com",
  "reason": "manual"
})
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("POST", "https://api.orbit.devotel.io/api/v1/email/suppressions", bytes.NewBuffer([]byte(`{
  "email": "customer@example.com",
  "reason": "manual"
}`)))
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))
	req.Header.Set("Content-Type", "application/json")
	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/email/suppressions')
req = Net::HTTP::Post.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']
req['Content-Type'] = 'application/json'
req.body = {
  "email": "customer@example.com",
  "reason": "manual"
}.to_json
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/email/suppressions');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),
  'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, <<<JSON
{
  "email": "customer@example.com",
  "reason": "manual"
}
JSON);
echo curl_exec($ch);

{
  "data": {
    "id": "esuppression_2a9c5f1d",
    "email": "customer@example.com",
    "reason": "manual",
    "bounceType": null,
    "addedAt": "2026-07-20T09:14:00.000Z",
    "expiresAt": null
  },
  "meta": {
    "request_id": "req_supp_add",
    "timestamp": "2026-08-01T12:07:00.000Z"
  }
}

Suppressed addresses never receive sends — the send path rejects them before they reach the provider. Manual reason accepts manual, unsubscribe, complaint, or hard_bounce; bounce/automatic entries (collector handles them) carry the machine reasons. Repeat an add and it returns 200 with the existing entry rather than 201. Bulk-import (POST /api/v1/email/suppressions/bulk-import) accepts either CSV text (one address per line, optional email header row tolerated) or an emails array: Request

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/email/suppressions/bulk-import" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
  "csv": "email\nbounced@example.com\ncomplained@example.com",
  "reason": "hard_bounce"
}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/suppressions/bulk-import', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "csv": "email\nbounced@example.com\ncomplained@example.com",
  "reason": "hard_bounce"
}),
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
headers["Content-Type"] = "application/json"
r = requests.post("https://api.orbit.devotel.io/api/v1/email/suppressions/bulk-import", headers=headers, json={
  "csv": "email\nbounced@example.com\ncomplained@example.com",
  "reason": "hard_bounce"
})
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("POST", "https://api.orbit.devotel.io/api/v1/email/suppressions/bulk-import", bytes.NewBuffer([]byte(`{
  "csv": "email\nbounced@example.com\ncomplained@example.com",
  "reason": "hard_bounce"
}`)))
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))
	req.Header.Set("Content-Type", "application/json")
	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/email/suppressions/bulk-import')
req = Net::HTTP::Post.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']
req['Content-Type'] = 'application/json'
req.body = {
  "csv": "email\nbounced@example.com\ncomplained@example.com",
  "reason": "hard_bounce"
}.to_json
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/email/suppressions/bulk-import');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),
  'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, <<<JSON
{
  "csv": "email\nbounced@example.com\ncomplained@example.com",
  "reason": "hard_bounce"
}
JSON);
echo curl_exec($ch);

{
  "data": {
    "imported": 2,
    "skipped": 0,
    "invalid": 0
  },
  "meta": {
    "request_id": "req_supp_bulk",
    "timestamp": "2026-08-01T12:08:00.000Z"
  }
}

imported counts newly-added entries; skipped counts duplicates already on the list; invalid counts malformed addresses dropped. GET /api/v1/email/suppressions pages the list (?limit=&offset=&search=&reason=):

{
  "data": {
    "entries": [
      {
        "id": "esuppression_2a9c5f1d",
        "email": "customer@example.com",
        "reason": "manual",
        "bounceType": null,
        "addedAt": "2026-07-20T09:14:00.000Z",
        "expiresAt": null
      },
      {
        "id": "esuppression_7b21e03c",
        "email": "bounced@example.com",
        "reason": "hard_bounce",
        "bounceType": "hard",
        "addedAt": "2026-07-18T22:41:00.000Z",
        "expiresAt": "2026-08-17T22:41:00.000Z"
      }
    ],
    "total": 2
  },
  "meta": {
    "request_id": "req_supp_list",
    "timestamp": "2026-08-01T12:09:00.000Z"
  }
}

Remove an entry with DELETE /api/v1/email/suppressions/{id} (returns { "ok": true }). GET /api/v1/email/suppressions/reputation?days=30 reports a suppression-rate breakdown by reason over trailing send volume — the number a deliverability review quotes.

8. Poll readiness and DNS, then promote to default

Once the DNS records publish (step 4), poll until the records show valid and then promote the sender to the org default. The Node.js escape hatch — the SDK is generated from this same OpenAPI contract, so a typed client covers it; raw fetch is fine too:

curl -X GET "https://api.orbit.devotel.io/api/v1/email/domains/dome_2b8c1a4f9e/dns-status?refresh=true" \
  -H "X-API-Key: dv_live_sk_your_key_here"

const domainId = 'dome_2b8c1a4f9e'
const senderId = 'esend_9f3ab2d61c4a'

const poll = async () => {
  const res = await fetch(`https://api.orbit.devotel.io/api/v1/email/domains/${domainId}/dns-status?refresh=true`, {
    headers: { 'X-API-Key': process.env.ORBIT_API_KEY! },
  })
  const { data } = await res.json()
  return data.overallStatus === 'valid' // or take `data.records` for the per-record traffic light
}

// Poll every minute; DNS propagation usually settles within 10 minutes.
const deadline = Date.now() + 10 * 60_000
while (Date.now() < deadline) {
  if (await poll()) break
  await new Promise((r) => setTimeout(r, 60_000))
}

await fetch(`https://api.orbit.devotel.io/api/v1/email/senders/${senderId}/set-default`, {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: '{}', // no body fields — the promotion is id-jointed
})

refresh=true re-verifies at the provider, not just at DNS — pass it when you just published the records. The promote call accepts no body; steps 3–5 above show the shapes.

Warmup, dedicated IP, TLS reports, and inbound routing (advanced)

These complete the sender’s onboard checklist; most tenants never need them. POST /api/v1/email/inbound-routes registers an inbound subdomain→destination mapping (webhook): Request

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/email/inbound-routes" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
  "pattern": "support/tickets-<tenant>",
  "destination": {
    "type": "webhook",
    "url": "https://your-app.example/inbound/email",
    "authHeader": "Bearer your-token"
  }
}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/inbound-routes', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "pattern": "support/tickets-<tenant>",
  "destination": {
    "type": "webhook",
    "url": "https://your-app.example/inbound/email",
    "authHeader": "Bearer your-token"
  }
}),
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
headers["Content-Type"] = "application/json"
r = requests.post("https://api.orbit.devotel.io/api/v1/email/inbound-routes", headers=headers, json={
  "pattern": "support/tickets-<tenant>",
  "destination": {
    "type": "webhook",
    "url": "https://your-app.example/inbound/email",
    "authHeader": "Bearer your-token"
  }
})
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("POST", "https://api.orbit.devotel.io/api/v1/email/inbound-routes", bytes.NewBuffer([]byte(`{
  "pattern": "support/tickets-<tenant>",
  "destination": {
    "type": "webhook",
    "url": "https://your-app.example/inbound/email",
    "authHeader": "Bearer your-token"
  }
}`)))
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))
	req.Header.Set("Content-Type", "application/json")
	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/email/inbound-routes')
req = Net::HTTP::Post.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']
req['Content-Type'] = 'application/json'
req.body = {
  "pattern": "support/tickets-<tenant>",
  "destination": {
    "type": "webhook",
    "url": "https://your-app.example/inbound/email",
    "authHeader": "Bearer your-token"
  }
}.to_json
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/email/inbound-routes');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),
  'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, <<<JSON
{
  "pattern": "support/tickets-<tenant>",
  "destination": {
    "type": "webhook",
    "url": "https://your-app.example/inbound/email",
    "authHeader": "Bearer your-token"
  }
}
JSON);
echo curl_exec($ch);

{
  "data": {
    "id": "einrt_3b7f2a9d1c",
    "pattern": "support/tickets-<tenant>",
    "destination": {
      "type": "webhook",
      "url": "https://your-app.example/inbound/email"
    }
  },
  "meta": {
    "request_id": "req_inrt_cre",
    "timestamp": "2026-08-01T12:30:00.000Z"
  }
}

GET /api/v1/email/warmup-plan returns the day-by-day ramp for your ?targetDailyVolume=:

{
  "data": {
    "targetDailyVolume": 50000,
    "startingVolume": 750,
    "growthFactor": 2,
    "lookbackDays": 30,
    "days": [
      {
        "day": 1,
        "dailyVolume": 750
      },
      {
        "day": 3,
        "dailyVolume": 1500
      },
      {
        "day": 9,
        "dailyVolume": 3750
      },
      {
        "day": 25,
        "dailyVolume": 18750
      }
    ]
  },
  "meta": {
    "request_id": "req_warmup_plan",
    "timestamp": "2026-08-01T12:26:00.000Z"
  }
}

GET /api/v1/email/warmup-status adds what you have actually sent (sent.totalSent, the live-day current.maxAllowed, and reputation). GET /api/v1/email/warmup-enforcement answers “which batches get sent when the pattern doesn’t match a plan day” for a requested batch.

Dedicated sending — eligibility, request, status

Check eligibility (GET /api/v1/email/dedicated-sending/eligibility) against your actual trailing-30-day volume, submit a free-text request, then read back the server-authoritative status (GET /api/v1/email/dedicated-sending):

curl -X GET "https://api.orbit.devotel.io/api/v1/email/dedicated-sending/eligibility" \
  -H "X-API-Key: dv_live_sk_your_key_here"

const headers = { 'X-API-Key': process.env.ORBIT_API_KEY! }

const readStatus = async () => {
  const res = await fetch('https://api.orbit.devotel.io/api/v1/email/dedicated-sending', { headers })
  const { data } = await res.json()
  // data.request.state — `none` | `pending_provisioning` | `active`
  // data.eligibility.monthlySendVolume / .thresholdPerMonth / .eligible
  return data
}

Eligibility read (eligibility is also nested inside GET /dedicated-sending):

{
  "data": {
    "monthlySendVolume": 61200,
    "thresholdPerMonth": 50000,
    "eligible": true,
    "status": "eligible",
    "averageDailyVolume": 2040,
    "warmupPlan": {
      "targetDailyVolume": 2040,
      "startingVolume": 750,
      "growthFactor": 2,
      "totalDays": 25,
      "days": [
        { "day": 1, "dailyVolume": 750 },
        { "day": 3, "dailyVolume": 1500 }
      ]
    },
    "message": "At 61200 emails/month this workspace clears the ~50000/month bar for a dedicated sending IP…"
  },
  "meta": {
    "request_id": "req_ded_eligible",
    "timestamp": "2026-08-01T12:32:00.000Z"
  }
}

Status read after submitting POST /dedicated-sending/request with a justification note:

{
  "data": {
    "request": {
      "state": "pending_provisioning",
      "requestedAt": "2026-08-01T12:33:00.000Z",
      "requestedByUserId": "user_2b8c1a4f9e0d",
      "monthlySendVolumeAtRequest": 61200,
      "note": "Bulk sender, outgrowing shared pool."
    },
    "eligibility": {
      "monthlySendVolume": 61200,
      "thresholdPerMonth": 50000,
      "eligible": true,
      "status": "eligible",
      "averageDailyVolume": 2040,
      "warmupPlan": null
    },
    "provisioningAvailable": true,
    "status": "pending_provisioning",
    "actionable": false
  },
  "meta": {
    "request_id": "req_ded_status",
    "timestamp": "2026-08-01T12:34:00.000Z"
  }
}

eligibility.monthlySendVolume comes from real send history, not a client estimate — the request is rejected 403 below the ~50k/month bar, and re-submitting a pending request returns the existing record.

TLS-report and Postmaster reputation reads

Two stateless analysis routes fold the aggregate reports mailbox providers mail (TLS-RPT) and the per-delivery reputation Google / feedback loops expose (Postmaster) into one tenant-side readout — no persistence, no quota to the provider. TLS-RPT — POST /api/v1/email/tls-rpt/reports/analyze (base64-encode the report body you receive, or publish the _smtp._tls.<domain> record providers attach as application/tlsrpt+gzip):

curl -X POST "https://api.orbit.devotel.io/api/v1/email/tls-rpt/reports/analyze" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
  "reports": [
    {
      "kind": "tlsrpt",
      "transport": "base64-json",
      "data": "eyJkb2N1bWVudCB9"
    }
  ],
  "topFailureTypes": 3
}'

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/tls-rpt/reports/analyze', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    reports: [
      { kind: 'tlsrpt', transport: 'base64-json', data: btoa(JSON.stringify(report)) },
    ],
    topFailureTypes: 3,
  }),
})
const { data } = await res.json()
// data.summary.successRate, data.summary.failuresByType, data.downgradeDetected

{
  "data": {
    "summary": {
      "domain": "acme.com",
      "reportCount": 2,
      "windowStart": 1786896000000,
      "windowEnd": 1787068800000,
      "totalSessions": 940,
      "successfulSessions": 897,
      "failedSessions": 43,
      "successRate": 0.9542553191489361,
      "failuresByType": [
        {
          "resultType": "starttls-not-supported",
          "downgradeSignal": true,
          "failedSessionCount": 31,
          "affectedMxHosts": ["mx.example.org"]
        }
      ]
    },
    "submittedReports": 2,
    "skippedReports": 0
  },
  "meta": {
    "request_id": "req_tls_analyze",
    "timestamp": "2026-08-01T12:35:00.000Z"
  }
}

Postmaster — POST /api/v1/email/postmaster/reputation/analyze (POST the payloads a tenant’s scheduled connector fetches from Google Postmaster Tools and your configured feedback loops — we deliberately do not pull from Google directly, so the route stays read-through):

curl -X POST "https://api.orbit.devotel.io/api/v1/email/postmaster/reputation/analyze" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
  "google": [
    {
      "name": "trafficStats/2026-08-01",
      "domainReputation": "HIGH",
      "userReportedSpamRatio": 0.0002,
      "authSuccessRatios": {
        "spf": 0.99,
        "dkim": 0.98,
        "dmarc": 0.98
      }
    }
  ],
  "feedback": []
}'

const { data } = await fetch('https://api.orbit.devotel.io/api/v1/email/postmaster/reputation/analyze', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ google, feedback }),
}).then((r) => r.json())
// data.domainReputation ("high" | "medium" | "low" | "bad" | "unknown"),
// data.spamRate, data.authSuccessRatios, data.deliveryErrors, data.recommendations

{
  "data": {
    "domainReputation": "high",
    "spamRate": 0.0002,
    "authSuccessRatios": {
      "spf": 0.99,
      "dkim": 0.98,
      "dmarc": 0.98
    },
    "ipReputation": {
      "high": 2,
      "medium": 0,
      "low": 0,
      "bad": 0,
      "unknown": 0,
      "totalIps": 2
    },
    "deliveryErrors": [],
    "recommendations": [],
    "submitted": { "google": 1, "feedback": 0 },
    "skipped": { "google": 0, "feedback": 0 }
  },
  "meta": {
    "request_id": "req_pst_analyze",
    "timestamp": "2026-08-01T12:36:00.000Z"
  }
}

Malformed records are skipped and counted in skipped, never thrown — a corrupt attachment or a single bad snapshot never sinks the batch.

Get dedicated sending status

GET /api/v1/email/dedicated-sending

Retrieve the organization’s dedicated sending IP status based on actual trailing-30-day email volume. Returns eligibility status, current request status (pending, approved, etc.), and provisioning details. Server-authoritative; uses real send volume from the messages table, not client-supplied estimates. Requires owner or admin role.

string (enum: true|false)

Sandbox opt-in for Clerk-session-authenticated requests. Set to true to route the call through the test-mode pipeline: no real provider delivery, no credits deducted, response meta.test_mode: true. Ignored for live API keys (dv_live_sk_*) — server-to-server clients must use a test-prefixed key (dv_test_sk_*) to exercise sandbox. Test-prefixed keys unconditionally enable sandbox regardless of this header.

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/email/dedicated-sending" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/dedicated-sending', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
r = requests.get("https://api.orbit.devotel.io/api/v1/email/dedicated-sending", headers=headers)
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.orbit.devotel.io/api/v1/email/dedicated-sending", nil)
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))

	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/email/dedicated-sending')
req = Net::HTTP::Get.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']


res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/email/dedicated-sending');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),

]);

echo curl_exec($ch);

{
  "data": {
    "id": "esend_9f3ab2d61c4a",
    "domain": "mail.acme.com",
    "default_from_email": "offers@acme.com",
    "default_from_name": "Acme Offers",
    "default_reply_to": "support@acme.com",
    "isDefault": true,
    "streamId": null
  },
  "meta": {
    "request_id": "req_send_upd",
    "timestamp": "2026-08-01T12:05:00.000Z"
  }
}

Check dedicated IP eligibility

GET /api/v1/email/dedicated-sending/eligibility

Assess whether the organization qualifies for a dedicated sending IP based on projected monthly send volume (~50k/month threshold). Returns eligibility status and a recommended IP-warmup ramp if eligible. Pure computation with no IP provisioning or billing changes. Requires owner or admin role.

string (enum: true|false)

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/email/dedicated-sending/eligibility" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/dedicated-sending/eligibility', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
r = requests.get("https://api.orbit.devotel.io/api/v1/email/dedicated-sending/eligibility", headers=headers)
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.orbit.devotel.io/api/v1/email/dedicated-sending/eligibility", nil)
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))

	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/email/dedicated-sending/eligibility')
req = Net::HTTP::Get.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']


res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/email/dedicated-sending/eligibility');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),

]);

echo curl_exec($ch);

{
  "data": {
    "id": "esend_9f3ab2d61c4a",
    "domain": "mail.acme.com",
    "default_from_email": "offers@acme.com",
    "default_from_name": "Acme Offers",
    "default_reply_to": "support@acme.com",
    "isDefault": true,
    "streamId": null
  },
  "meta": {
    "request_id": "req_send_upd",
    "timestamp": "2026-08-01T12:05:00.000Z"
  }
}

List sending domains

GET /api/v1/email/domains

List every sending domain your organization can use — the platform default plus your configured and registered sender domains. Returns the domain ids accepted by every per-domain endpoint (DNS status, DNS history, inbox placement, BIMI, test send); call this first to discover ids before drilling into a single domain. Read-only: no DNS lookup, no provider call. Requires owner or admin role.

string (enum: true|false)

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/email/domains" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/domains', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
r = requests.get("https://api.orbit.devotel.io/api/v1/email/domains", headers=headers)
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.orbit.devotel.io/api/v1/email/domains", nil)
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))

	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/email/domains')
req = Net::HTTP::Get.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']


res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/email/domains');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),

]);

echo curl_exec($ch);

{
  "data": {
    "id": "esend_9f3ab2d61c4a",
    "domain": "mail.acme.com",
    "default_from_email": "offers@acme.com",
    "default_from_name": "Acme Offers",
    "default_reply_to": "support@acme.com",
    "isDefault": true,
    "streamId": null
  },
  "meta": {
    "request_id": "req_send_upd",
    "timestamp": "2026-08-01T12:05:00.000Z"
  }
}

Get domains

GET /api/v1/email/domains/{domainId}

string

required

—

string (enum: true|false)

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/email/domains/{domainId}" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/domains/{domainId}', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
r = requests.get("https://api.orbit.devotel.io/api/v1/email/domains/{domainId}", headers=headers)
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.orbit.devotel.io/api/v1/email/domains/{domainId}", nil)
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))

	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/email/domains/{domainId}')
req = Net::HTTP::Get.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']


res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/email/domains/{domainId}');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),

]);

echo curl_exec($ch);

{
  "data": {
    "id": "esend_9f3ab2d61c4a",
    "domain": "mail.acme.com",
    "default_from_email": "offers@acme.com",
    "default_from_name": "Acme Offers",
    "default_reply_to": "support@acme.com",
    "isDefault": true,
    "streamId": null
  },
  "meta": {
    "request_id": "req_send_upd",
    "timestamp": "2026-08-01T12:05:00.000Z"
  }
}

Get domain DNS verification history

GET /api/v1/email/domains/{domainId}/dns-history

Retrieve the historical DNS verification record snapshots for a sending domain over the past N days (default 30). Shows when records were added, verified, or failed. Useful for debugging DNS propagation and troubleshooting verification issues. Requires owner or admin role.

string

required

—

string (enum: true|false)

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/email/domains/{domainId}/dns-history" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/domains/{domainId}/dns-history', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
r = requests.get("https://api.orbit.devotel.io/api/v1/email/domains/{domainId}/dns-history", headers=headers)
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.orbit.devotel.io/api/v1/email/domains/{domainId}/dns-history", nil)
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))

	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/email/domains/{domainId}/dns-history')
req = Net::HTTP::Get.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']


res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/email/domains/{domainId}/dns-history');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),

]);

echo curl_exec($ch);

{
  "data": {
    "id": "esend_9f3ab2d61c4a",
    "domain": "mail.acme.com",
    "default_from_email": "offers@acme.com",
    "default_from_name": "Acme Offers",
    "default_reply_to": "support@acme.com",
    "isDefault": true,
    "streamId": null
  },
  "meta": {
    "request_id": "req_send_upd",
    "timestamp": "2026-08-01T12:05:00.000Z"
  }
}

Check domain DNS records

GET /api/v1/email/domains/{domainId}/dns-status

Verify the SPF, DKIM, and DMARC DNS records for a sending domain. Returns a traffic-light status (verified, partial, or failed) for each record. Pass refresh=true to trigger a provider re-verification and update Resend’s domain status. Requires owner or admin role.

string

required

—

string (enum: true|false)

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/email/domains/{domainId}/dns-status" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/domains/{domainId}/dns-status', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
r = requests.get("https://api.orbit.devotel.io/api/v1/email/domains/{domainId}/dns-status", headers=headers)
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.orbit.devotel.io/api/v1/email/domains/{domainId}/dns-status", nil)
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))

	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/email/domains/{domainId}/dns-status')
req = Net::HTTP::Get.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']


res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/email/domains/{domainId}/dns-status');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),

]);

echo curl_exec($ch);

{
  "data": {
    "id": "esend_9f3ab2d61c4a",
    "domain": "mail.acme.com",
    "default_from_email": "offers@acme.com",
    "default_from_name": "Acme Offers",
    "default_reply_to": "support@acme.com",
    "isDefault": true,
    "streamId": null
  },
  "meta": {
    "request_id": "req_send_upd",
    "timestamp": "2026-08-01T12:05:00.000Z"
  }
}

Get domain inbox placement rate

GET /api/v1/email/domains/{domainId}/inbox-placement

Aggregate inbox placement statistics for a sending domain over the past N days (default 30). Shows the percentage of test emails delivered to inbox vs. spam/promotions folders across major ISPs. Computed from delivered test-send proofs. Returns zeros for domains with no test history. Requires owner or admin role.

string

required

—

string (enum: true|false)

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/email/domains/{domainId}/inbox-placement" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/domains/{domainId}/inbox-placement', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
r = requests.get("https://api.orbit.devotel.io/api/v1/email/domains/{domainId}/inbox-placement", headers=headers)
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.orbit.devotel.io/api/v1/email/domains/{domainId}/inbox-placement", nil)
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))

	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/email/domains/{domainId}/inbox-placement')
req = Net::HTTP::Get.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']


res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/email/domains/{domainId}/inbox-placement');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),

]);

echo curl_exec($ch);

{
  "data": {
    "id": "esend_9f3ab2d61c4a",
    "domain": "mail.acme.com",
    "default_from_email": "offers@acme.com",
    "default_from_name": "Acme Offers",
    "default_reply_to": "support@acme.com",
    "isDefault": true,
    "streamId": null
  },
  "meta": {
    "request_id": "req_send_upd",
    "timestamp": "2026-08-01T12:05:00.000Z"
  }
}

Get test email send result

GET /api/v1/email/domains/{domainId}/test-send/{testId}/result

Retrieve the delivery and spam-scoring results from a test email send. Shows which ISPs delivered to inbox vs. spam, SPF/DKIM/DMARC authentication results, and an estimated spam score. Returns 404 if the test has not yet completed or been delivered. Requires owner or admin role.

string

required

—

string

required

—

string (enum: true|false)

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/email/domains/{domainId}/test-send/test_3b5c7d9e1f/result" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/domains/{domainId}/test-send/test_3b5c7d9e1f/result', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
r = requests.get("https://api.orbit.devotel.io/api/v1/email/domains/{domainId}/test-send/test_3b5c7d9e1f/result", headers=headers)
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.orbit.devotel.io/api/v1/email/domains/{domainId}/test-send/test_3b5c7d9e1f/result", nil)
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))

	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/email/domains/{domainId}/test-send/test_3b5c7d9e1f/result')
req = Net::HTTP::Get.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']


res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/email/domains/{domainId}/test-send/test_3b5c7d9e1f/result');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),

]);

echo curl_exec($ch);

{
  "data": {
    "id": "esend_9f3ab2d61c4a",
    "domain": "mail.acme.com",
    "default_from_email": "offers@acme.com",
    "default_from_name": "Acme Offers",
    "default_reply_to": "support@acme.com",
    "isDefault": true,
    "streamId": null
  },
  "meta": {
    "request_id": "req_send_upd",
    "timestamp": "2026-08-01T12:05:00.000Z"
  }
}

List inbound email routes

GET /api/v1/email/inbound-routes

Retrieve all configured inbound email routes for the authenticated organization. Routes match incoming messages against recipient patterns and forward parsed email as JSON to a destination webhook. Signing secrets are masked in responses. Requires owner or admin role.

string (enum: true|false)

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/email/inbound-routes" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/inbound-routes', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
r = requests.get("https://api.orbit.devotel.io/api/v1/email/inbound-routes", headers=headers)
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.orbit.devotel.io/api/v1/email/inbound-routes", nil)
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))

	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/email/inbound-routes')
req = Net::HTTP::Get.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']


res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/email/inbound-routes');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),

]);

echo curl_exec($ch);

{
  "data": {
    "id": "esend_9f3ab2d61c4a",
    "domain": "mail.acme.com",
    "default_from_email": "offers@acme.com",
    "default_from_name": "Acme Offers",
    "default_reply_to": "support@acme.com",
    "isDefault": true,
    "streamId": null
  },
  "meta": {
    "request_id": "req_send_upd",
    "timestamp": "2026-08-01T12:05:00.000Z"
  }
}

List email senders

GET /api/v1/email/senders

Return every email sender registered for the calling organization: domain, default From: address/name, Reply-To, the isDefault flag, and the sending-stream assignment. Use this to populate the compose dropdown and the Senders settings table. Includes the legacy esend_legacy_<slug> row when the org still uses a flat channels domain. Requires owner or admin role.

string (enum: true|false)

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/email/senders" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/senders', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
r = requests.get("https://api.orbit.devotel.io/api/v1/email/senders", headers=headers)
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.orbit.devotel.io/api/v1/email/senders", nil)
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))

	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/email/senders')
req = Net::HTTP::Get.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']


res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/email/senders');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),

]);

echo curl_exec($ch);

{
  "data": {
    "id": "esend_9f3ab2d61c4a",
    "domain": "mail.acme.com",
    "default_from_email": "offers@acme.com",
    "default_from_name": "Acme Offers",
    "default_reply_to": "support@acme.com",
    "isDefault": true,
    "streamId": null
  },
  "meta": {
    "request_id": "req_send_upd",
    "timestamp": "2026-08-01T12:05:00.000Z"
  }
}

Get one email sender

GET /api/v1/email/senders/{senderId}

Retrieve a single email sender by id — including the legacy esend_legacy_<slug> ids the list endpoint advertises. Use it to fetch the sender’s domain, from-fields, and stream assignment before editing. Returns 404 when the id does not exist for the organization. Requires owner or admin role.

string

required

Sender id (esend_… or esend_legacy_<slug>).

string (enum: true|false)

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/email/senders/{senderId}" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/senders/{senderId}', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
r = requests.get("https://api.orbit.devotel.io/api/v1/email/senders/{senderId}", headers=headers)
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.orbit.devotel.io/api/v1/email/senders/{senderId}", nil)
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))

	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/email/senders/{senderId}')
req = Net::HTTP::Get.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']


res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/email/senders/{senderId}');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),

]);

echo curl_exec($ch);

{
  "data": {
    "id": "esend_9f3ab2d61c4a",
    "domain": "mail.acme.com",
    "default_from_email": "offers@acme.com",
    "default_from_name": "Acme Offers",
    "default_reply_to": "support@acme.com",
    "isDefault": true,
    "streamId": null
  },
  "meta": {
    "request_id": "req_send_upd",
    "timestamp": "2026-08-01T12:05:00.000Z"
  }
}

List streams

GET /api/v1/email/streams

string (enum: true|false)

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/email/streams" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/streams', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
r = requests.get("https://api.orbit.devotel.io/api/v1/email/streams", headers=headers)
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.orbit.devotel.io/api/v1/email/streams", nil)
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))

	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/email/streams')
req = Net::HTTP::Get.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']


res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/email/streams');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),

]);

echo curl_exec($ch);

{
  "data": {
    "id": "esend_9f3ab2d61c4a",
    "domain": "mail.acme.com",
    "default_from_email": "offers@acme.com",
    "default_from_name": "Acme Offers",
    "default_reply_to": "support@acme.com",
    "isDefault": true,
    "streamId": null
  },
  "meta": {
    "request_id": "req_send_upd",
    "timestamp": "2026-08-01T12:05:00.000Z"
  }
}

List suppressed email addresses

GET /api/v1/email/suppressions

Page the tenant suppression list — addresses the platform will no longer send to, because of a bounce, complaint, unsubscribe, or manual block. Supports limit / offset pagination plus search and reason filters. Use it to audit why email to an address stopped and to decide which entry to remove. Requires owner or admin role.

integer

Page size (default 50, max 200). Coerced number falls back to the default on a malformed value.

integer

Zero-based row offset for pagination.

string

Substring filter on the suppressed address.

string

Filter by suppression reason (bounce, complaint, unsubscribe, manual).

string (enum: true|false)

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/email/suppressions" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/suppressions', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
r = requests.get("https://api.orbit.devotel.io/api/v1/email/suppressions", headers=headers)
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.orbit.devotel.io/api/v1/email/suppressions", nil)
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))

	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/email/suppressions')
req = Net::HTTP::Get.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']


res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/email/suppressions');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),

]);

echo curl_exec($ch);

{
  "data": {
    "id": "esend_9f3ab2d61c4a",
    "domain": "mail.acme.com",
    "default_from_email": "offers@acme.com",
    "default_from_name": "Acme Offers",
    "default_reply_to": "support@acme.com",
    "isDefault": true,
    "streamId": null
  },
  "meta": {
    "request_id": "req_send_upd",
    "timestamp": "2026-08-01T12:05:00.000Z"
  }
}

Export suppression list as CSV

GET /api/v1/email/suppressions/export

Download the full tenant suppression list as an RFC 4180 CSV (headers email, reason, bounce_type, added_at, expires_at). Use it to reconcile the blocklist against an external system or take an offline snapshot. Requires owner or admin role.

string (enum: true|false)

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/email/suppressions/export" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/suppressions/export', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
r = requests.get("https://api.orbit.devotel.io/api/v1/email/suppressions/export", headers=headers)
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.orbit.devotel.io/api/v1/email/suppressions/export", nil)
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))

	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/email/suppressions/export')
req = Net::HTTP::Get.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']


res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/email/suppressions/export');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),

]);

echo curl_exec($ch);

{
  "data": {
    "id": "esend_9f3ab2d61c4a",
    "domain": "mail.acme.com",
    "default_from_email": "offers@acme.com",
    "default_from_name": "Acme Offers",
    "default_reply_to": "support@acme.com",
    "isDefault": true,
    "streamId": null
  },
  "meta": {
    "request_id": "req_send_upd",
    "timestamp": "2026-08-01T12:05:00.000Z"
  }
}

Get sender-reputation summary

GET /api/v1/email/suppressions/reputation

Aggregate bounce and complaint counts for the tenant’s email sends over the lookback window (default last 30 days, configurable via days, max 90). Use it to spot deliverability regressions — a rising hard-bounce or complaint rate directly degrades sender reputation. Requires owner or admin role.

integer

Lookback window in days (default 30, max 90).

string (enum: true|false)

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/email/suppressions/reputation" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/suppressions/reputation', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
r = requests.get("https://api.orbit.devotel.io/api/v1/email/suppressions/reputation", headers=headers)
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.orbit.devotel.io/api/v1/email/suppressions/reputation", nil)
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))

	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/email/suppressions/reputation')
req = Net::HTTP::Get.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']


res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/email/suppressions/reputation');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),

]);

echo curl_exec($ch);

{
  "data": {
    "windowDays": 0,
    "sent": 0,
    "delivered": 0,
    "bounced": 0,
    "complaints": 0,
    "deliveryRate": 0,
    "bounceRate": 0,
    "complaintRate": 0,
    "reputation": {},
    "suppressionCount": 0
  }
}

One-click email unsubscribe

GET /api/v1/email/unsubscribe/{token}

Public List-Unsubscribe endpoint. Verifies the HMAC-signed token embedded in every outbound email’s List-Unsubscribe URL, records the recipient address on the tenant suppression list (idempotent), then either 302-redirects to the organization’s configured unsubscribe page or renders a minimal HTML confirmation. POST is the RFC 8058 one-click method (mailbox gateways POST without a body); GET is the human-click fallback. Invalid, expired, or tampered tokens return an HTTP 400 HTML error page.

string

required

HMAC-signed token binding tenant, message id, and recipient address; minted into the message’s List-Unsubscribe URL at send time.

string (enum: true|false)

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/email/unsubscribe/tkn_0c1d3e5f7a" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/unsubscribe/tkn_0c1d3e5f7a', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

{
  "data": {
    "id": "esend_9f3ab2d61c4a",
    "domain": "mail.acme.com",
    "default_from_email": "offers@acme.com",
    "default_from_name": "Acme Offers",
    "default_reply_to": "support@acme.com",
    "isDefault": true,
    "streamId": null
  },
  "meta": {
    "request_id": "req_send_upd",
    "timestamp": "2026-08-01T12:05:00.000Z"
  }
}

Check batch send against warmup headroom

GET /api/v1/email/warmup-enforcement

Split a proposed send batch against today’s live (feedback-adjusted) IP-warmup headroom into an allow / partial / block verdict — how many emails may go today, how many are deferred, and when headroom reopens. The operator supplies the steady-state targetDailyVolume plus the requested batch size; startingVolume / growthFactor are optional ramp-tuning knobs identical to /warmup-plan. Read-only: the verdict only ever withholds volume above today’s ceiling, it never authorises a send. Requires owner or admin role.

integer

required

Steady-state daily volume the warmup ramp aims toward (1-10M/day). Required.

integer

required

Batch size the caller wants to send now. Required.

integer

Optional custom day-one daily cap (same knob as /warmup-plan).

number

Optional daily-growth multiplier (1.05-4; default ~1.5).

string (enum: true|false)

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/email/warmup-enforcement" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/warmup-enforcement', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

{
  "data": {
    "id": "esend_9f3ab2d61c4a",
    "domain": "mail.acme.com",
    "default_from_email": "offers@acme.com",
    "default_from_name": "Acme Offers",
    "default_reply_to": "support@acme.com",
    "isDefault": true,
    "streamId": null
  },
  "meta": {
    "request_id": "req_send_upd",
    "timestamp": "2026-08-01T12:05:00.000Z"
  }
}

Get IP warmup ramp plan

GET /api/v1/email/warmup-plan

Generate the day-by-day send-volume cap schedule that builds sending reputation up to a steady-state target daily volume. Use it to plan a deliberate ramp before raising send volume on a cold IP or domain; startingVolume and growthFactor are optional tuning knobs. Pure computation — no email is sent and nothing is provisioned.

integer

required

Steady-state daily volume the warmup ramp aims toward (1-10M/day). Required.

integer

Optional custom day-one daily cap (overrides the default curve start).

number

Optional daily-growth multiplier applied day over day (1.05-4; default ~1.5).

string (enum: true|false)

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/email/warmup-plan" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/warmup-plan', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

{
  "data": {
    "id": "esend_9f3ab2d61c4a",
    "domain": "mail.acme.com",
    "default_from_email": "offers@acme.com",
    "default_from_name": "Acme Offers",
    "default_reply_to": "support@acme.com",
    "isDefault": true,
    "streamId": null
  },
  "meta": {
    "request_id": "req_send_upd",
    "timestamp": "2026-08-01T12:05:00.000Z"
  }
}

Get live IP warmup status

GET /api/v1/email/warmup-status

Report where the workspace currently sits on its IP-warmup ramp: the ramp day anchored to the first recorded outbound send, today’s recommended cap, the volume already sent today, the remaining headroom, and whether sending is still within the ramp. Live sending reputation (recent delivery and spam-complaint rates) can lower today’s ceiling while reputation recovers. Use it to decide how much volume is safe to send right now.

integer

required

Steady-state daily volume the warmup ramp aims toward (1-10M/day). Required.

integer

Optional custom day-one daily cap (same knob as /warmup-plan).

number

Optional daily-growth multiplier (1.05-4; default ~1.5).

string (enum: true|false)

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/email/warmup-status" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/warmup-status', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

{
  "data": {
    "id": "esend_9f3ab2d61c4a",
    "domain": "mail.acme.com",
    "default_from_email": "offers@acme.com",
    "default_from_name": "Acme Offers",
    "default_reply_to": "support@acme.com",
    "isDefault": true,
    "streamId": null
  },
  "meta": {
    "request_id": "req_send_upd",
    "timestamp": "2026-08-01T12:05:00.000Z"
  }
}

Request a dedicated sending IP

POST /api/v1/email/dedicated-sending/request

Submit a request for a dedicated sending IP. The organization must send >50k emails/month to qualify (verified against actual trailing-30-day volume). The request is recorded and fulfilled out-of-band by Devotel; no IP is provisioned immediately. Idempotent; re-submitting the same request returns the status unchanged. Requires owner or admin role.

string

Stripe-style idempotency token. Pass a stable, client-generated value (1-255 chars) to dedupe retries on transient timeouts. The same key+credential+path replays the original response for 24h on 2xx (5min on 4xx, 30s on 5xx). Returns 409 if a concurrent request with the same key is already in flight; replayed responses include the Idempotency-Replay: true response header.

string (enum: true|false)

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/email/dedicated-sending/request" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/dedicated-sending/request', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": {
    "id": "esend_9f3ab2d61c4a",
    "domain": "mail.acme.com",
    "default_from_email": "offers@acme.com",
    "default_from_name": "Acme Offers",
    "default_reply_to": "support@acme.com",
    "isDefault": true,
    "streamId": null
  },
  "meta": {
    "request_id": "req_send_upd",
    "timestamp": "2026-08-01T12:05:00.000Z"
  }
}

Analyze reports

POST /api/v1/email/dmarc/reports/analyze

string

string (enum: true|false)

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/email/dmarc/reports/analyze" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/dmarc/reports/analyze', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": {
    "id": "esend_9f3ab2d61c4a",
    "domain": "mail.acme.com",
    "default_from_email": "offers@acme.com",
    "default_from_name": "Acme Offers",
    "default_reply_to": "support@acme.com",
    "isDefault": true,
    "streamId": null
  },
  "meta": {
    "request_id": "req_send_upd",
    "timestamp": "2026-08-01T12:05:00.000Z"
  }
}

Configure BIMI brand logo

POST /api/v1/email/domains/{domainId}/bimi

Set up BIMI (Brand Indicators for Message Identification) to display your brand logo next to emails in compatible mail clients. Supply logo URL and optional VMC (Verified Mark Certificate) URL. Validates the configuration against DNS records and DMARC requirements. Requires DMARC policy enforcement and owner or admin role.

string

required

—

string

string (enum: true|false)

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/email/domains/{domainId}/bimi" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/domains/{domainId}/bimi', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": {
    "id": "esend_9f3ab2d61c4a",
    "domain": "mail.acme.com",
    "default_from_email": "offers@acme.com",
    "default_from_name": "Acme Offers",
    "default_reply_to": "support@acme.com",
    "isDefault": true,
    "streamId": null
  },
  "meta": {
    "request_id": "req_send_upd",
    "timestamp": "2026-08-01T12:05:00.000Z"
  }
}

Create mta-sts

POST /api/v1/email/domains/{domainId}/mta-sts

string

required

—

string

string (enum: true|false)

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/email/domains/{domainId}/mta-sts" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/domains/{domainId}/mta-sts', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": {
    "id": "esend_9f3ab2d61c4a",
    "domain": "mail.acme.com",
    "default_from_email": "offers@acme.com",
    "default_from_name": "Acme Offers",
    "default_reply_to": "support@acme.com",
    "isDefault": true,
    "streamId": null
  },
  "meta": {
    "request_id": "req_send_upd",
    "timestamp": "2026-08-01T12:05:00.000Z"
  }
}

Initiate a test email send

POST /api/v1/email/domains/{domainId}/test-send

Start a test email send for a domain to verify delivery and measure inbox placement across major ISPs. The test email is signed with a generic orbittest.devotel.io DKIM key (not your domain’s key). Returns immediately with a test ID; poll the result endpoint to retrieve delivery and spam scoring details. Requires owner or admin role.

string

required

—

string

string (enum: true|false)

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/email/domains/{domainId}/test-send" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/domains/{domainId}/test-send', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": {
    "id": "esend_9f3ab2d61c4a",
    "domain": "mail.acme.com",
    "default_from_email": "offers@acme.com",
    "default_from_name": "Acme Offers",
    "default_reply_to": "support@acme.com",
    "isDefault": true,
    "streamId": null
  },
  "meta": {
    "request_id": "req_send_upd",
    "timestamp": "2026-08-01T12:05:00.000Z"
  }
}

Register an inbound email route

POST /api/v1/email/inbound-routes

Create a new inbound email route that matches incoming messages by recipient pattern and forwards the parsed email payload to a destination webhook URL. The route is assigned a unique signing secret, returned once at creation. Requires owner or admin role.

string

string (enum: true|false)

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/email/inbound-routes" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/inbound-routes', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": {
    "id": "esend_9f3ab2d61c4a",
    "domain": "mail.acme.com",
    "default_from_email": "sales@acme.com",
    "default_from_name": "Acme Sales",
    "default_reply_to": "support@acme.com",
    "isDefault": true,
    "streamId": null
  },
  "meta": {
    "request_id": "req_send_reg",
    "timestamp": "2026-08-01T12:00:00.000Z"
  }
}

Analyze Google Postmaster Tools + feedback-loop reputation data

POST /api/v1/email/postmaster/reputation/analyze

string

string (enum: true|false)

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/email/postmaster/reputation/analyze" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/postmaster/reputation/analyze', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": {
    "id": "esend_9f3ab2d61c4a",
    "domain": "mail.acme.com",
    "default_from_email": "offers@acme.com",
    "default_from_name": "Acme Offers",
    "default_reply_to": "support@acme.com",
    "isDefault": true,
    "streamId": null
  },
  "meta": {
    "request_id": "req_send_upd",
    "timestamp": "2026-08-01T12:05:00.000Z"
  }
}

Senders email

POST /api/v1/email/senders

string

string (enum: true|false)

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/email/senders" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/senders', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": {
    "id": "esend_9f3ab2d61c4a",
    "domain": "mail.acme.com",
    "default_from_email": "offers@acme.com",
    "default_from_name": "Acme Offers",
    "default_reply_to": "support@acme.com",
    "isDefault": true,
    "streamId": null
  },
  "meta": {
    "request_id": "req_send_upd",
    "timestamp": "2026-08-01T12:05:00.000Z"
  }
}

Create set-default

POST /api/v1/email/senders/{senderId}/set-default

string

required

—

string

string (enum: true|false)

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/email/senders/{senderId}/set-default" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/senders/{senderId}/set-default', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": {
    "id": "esend_9f3ab2d61c4a",
    "domain": "mail.acme.com",
    "default_from_email": "offers@acme.com",
    "default_from_name": "Acme Offers",
    "default_reply_to": "support@acme.com",
    "isDefault": true,
    "streamId": null
  },
  "meta": {
    "request_id": "req_send_upd",
    "timestamp": "2026-08-01T12:05:00.000Z"
  }
}

Streams email

POST /api/v1/email/streams

string

string (enum: true|false)

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/email/streams" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/streams', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": {
    "id": "esend_9f3ab2d61c4a",
    "domain": "mail.acme.com",
    "default_from_email": "offers@acme.com",
    "default_from_name": "Acme Offers",
    "default_reply_to": "support@acme.com",
    "isDefault": true,
    "streamId": null
  },
  "meta": {
    "request_id": "req_send_upd",
    "timestamp": "2026-08-01T12:05:00.000Z"
  }
}

Create set-default

POST /api/v1/email/streams/{streamId}/set-default

string

required

—

string

string (enum: true|false)

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/email/streams/{streamId}/set-default" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/streams/{streamId}/set-default', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": {
    "id": "esend_9f3ab2d61c4a",
    "domain": "mail.acme.com",
    "default_from_email": "offers@acme.com",
    "default_from_name": "Acme Offers",
    "default_reply_to": "support@acme.com",
    "isDefault": true,
    "streamId": null
  },
  "meta": {
    "request_id": "req_send_upd",
    "timestamp": "2026-08-01T12:05:00.000Z"
  }
}

Suppressions email

POST /api/v1/email/suppressions

string

string (enum: true|false)

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/email/suppressions" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/suppressions', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": {
    "id": "esend_9f3ab2d61c4a",
    "domain": "mail.acme.com",
    "default_from_email": "offers@acme.com",
    "default_from_name": "Acme Offers",
    "default_reply_to": "support@acme.com",
    "isDefault": true,
    "streamId": null
  },
  "meta": {
    "request_id": "req_send_upd",
    "timestamp": "2026-08-01T12:05:00.000Z"
  }
}

Bulk-import suppressions

POST /api/v1/email/suppressions/bulk-import

string

string (enum: true|false)

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/email/suppressions/bulk-import" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/suppressions/bulk-import', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": {
    "id": "esend_9f3ab2d61c4a",
    "domain": "mail.acme.com",
    "default_from_email": "offers@acme.com",
    "default_from_name": "Acme Offers",
    "default_reply_to": "support@acme.com",
    "isDefault": true,
    "streamId": null
  },
  "meta": {
    "request_id": "req_send_upd",
    "timestamp": "2026-08-01T12:05:00.000Z"
  }
}

Analyze TLS-RPT aggregate reports

POST /api/v1/email/tls-rpt/reports/analyze

string

string (enum: true|false)

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/email/tls-rpt/reports/analyze" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/tls-rpt/reports/analyze', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": {
    "id": "esend_9f3ab2d61c4a",
    "domain": "mail.acme.com",
    "default_from_email": "offers@acme.com",
    "default_from_name": "Acme Offers",
    "default_reply_to": "support@acme.com",
    "isDefault": true,
    "streamId": null
  },
  "meta": {
    "request_id": "req_send_upd",
    "timestamp": "2026-08-01T12:05:00.000Z"
  }
}

One-click email unsubscribe

POST /api/v1/email/unsubscribe/{token}

string

required

HMAC-signed token binding tenant, message id, and recipient address; minted into the message’s List-Unsubscribe URL at send time.

string

string (enum: true|false)

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/email/unsubscribe/tkn_0c1d3e5f7a" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/unsubscribe/tkn_0c1d3e5f7a', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": {
    "id": "esend_9f3ab2d61c4a",
    "domain": "mail.acme.com",
    "default_from_email": "offers@acme.com",
    "default_from_name": "Acme Offers",
    "default_reply_to": "support@acme.com",
    "isDefault": true,
    "streamId": null
  },
  "meta": {
    "request_id": "req_send_upd",
    "timestamp": "2026-08-01T12:05:00.000Z"
  }
}

Validate a recipient email address

POST /api/v1/email/validate

Score a single recipient email address before you send to it (SendGrid Email Validation parity). Checks syntax, MX resolution, disposable-domain and role-based-mailbox signals, computes a likely-typo correction, and folds everything into an aggregate 0–1 risk score with a coarse risk band — pure DNS + heuristics, no SMTP mailbox probing and no third-party feed. Use it to scrub one recipient row at a time as a user types or pastes; use POST /api/v1/email/validate/bulk to scrub a whole list in one call. The address is never persisted (transient validation only). Owner / admin only; an invalid body returns 422 and an unexpected validator failure returns 500.

string

string (enum: true|false)

any

Recipient address to validate — 3 to 254 characters (required).

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/email/validate" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/validate', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": {
    "id": "esend_9f3ab2d61c4a",
    "domain": "mail.acme.com",
    "default_from_email": "offers@acme.com",
    "default_from_name": "Acme Offers",
    "default_reply_to": "support@acme.com",
    "isDefault": true,
    "streamId": null
  },
  "meta": {
    "request_id": "req_send_upd",
    "timestamp": "2026-08-01T12:05:00.000Z"
  }
}

Bulk-validate recipient email addresses

POST /api/v1/email/validate/bulk

Score a list of recipient email addresses in one call before you import a contact list or launch a campaign. Each address is checked for syntax, MX resolution, disposable-domain and role-account signals, and a likely-typo correction, then rolled into a per-row verdict plus an aggregate summary (total, valid, invalid, risky). Accepts up to 1,000 addresses per call (de-duplicated case-insensitively), runs the MX fan-out behind a concurrency cap, and meters one usage event per call with quantity = distinct addresses validated (sandbox traffic is never metered). Use it to surface undeliverable or risky rows pre-import; use POST /api/v1/email/validate for a single address. Recipient addresses are never persisted. Invalid bodies return 422.

string

string (enum: true|false)

any

Address list to validate — 1 to 1,000 entries, each 3–254 characters. De-duplicated case-insensitively before validation; one result row per distinct address, input order preserved (required).

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/email/validate/bulk" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/validate/bulk', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": {
    "id": "esend_9f3ab2d61c4a",
    "domain": "mail.acme.com",
    "default_from_email": "offers@acme.com",
    "default_from_name": "Acme Offers",
    "default_reply_to": "support@acme.com",
    "isDefault": true,
    "streamId": null
  },
  "meta": {
    "request_id": "req_send_upd",
    "timestamp": "2026-08-01T12:05:00.000Z"
  }
}

Update senders

PUT /api/v1/email/senders/{senderId}

string

required

—

string

string (enum: true|false)

cURL

curl -X PUT "https://api.orbit.devotel.io/api/v1/email/senders/{senderId}" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/senders/{senderId}', {
  method: 'PUT',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": {
    "id": "esend_9f3ab2d61c4a",
    "domain": "mail.acme.com",
    "default_from_email": "offers@acme.com",
    "default_from_name": "Acme Offers",
    "default_reply_to": "support@acme.com",
    "isDefault": true,
    "streamId": null
  },
  "meta": {
    "request_id": "req_send_upd",
    "timestamp": "2026-08-01T12:05:00.000Z"
  }
}

Update streams

PUT /api/v1/email/streams/{streamId}

string

required

—

string

string (enum: true|false)

cURL

curl -X PUT "https://api.orbit.devotel.io/api/v1/email/streams/{streamId}" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/streams/{streamId}', {
  method: 'PUT',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": {
    "id": "esend_9f3ab2d61c4a",
    "domain": "mail.acme.com",
    "default_from_email": "offers@acme.com",
    "default_from_name": "Acme Offers",
    "default_reply_to": "support@acme.com",
    "isDefault": true,
    "streamId": null
  },
  "meta": {
    "request_id": "req_send_upd",
    "timestamp": "2026-08-01T12:05:00.000Z"
  }
}

Delete an inbound email route

DELETE /api/v1/email/inbound-routes/{routeId}

Remove an inbound email route from the organization. The route will no longer match or forward incoming emails. Returns success when the route is deleted. Requires owner or admin role.

string

required

—

string (enum: true|false)

cURL

curl -X DELETE "https://api.orbit.devotel.io/api/v1/email/inbound-routes/{routeId}" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/inbound-routes/{routeId}', {
  method: 'DELETE',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": {
    "id": "esend_9f3ab2d61c4a",
    "domain": "mail.acme.com",
    "default_from_email": "offers@acme.com",
    "default_from_name": "Acme Offers",
    "default_reply_to": "support@acme.com",
    "isDefault": true,
    "streamId": null
  },
  "meta": {
    "request_id": "req_send_upd",
    "timestamp": "2026-08-01T12:05:00.000Z"
  }
}

Delete senders

DELETE /api/v1/email/senders/{senderId}

string

required

—

string (enum: true|false)

cURL

curl -X DELETE "https://api.orbit.devotel.io/api/v1/email/senders/{senderId}" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/senders/{senderId}', {
  method: 'DELETE',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": {
    "id": "esend_9f3ab2d61c4a",
    "domain": "mail.acme.com",
    "default_from_email": "offers@acme.com",
    "default_from_name": "Acme Offers",
    "default_reply_to": "support@acme.com",
    "isDefault": true,
    "streamId": null
  },
  "meta": {
    "request_id": "req_send_upd",
    "timestamp": "2026-08-01T12:05:00.000Z"
  }
}

Delete streams

DELETE /api/v1/email/streams/{streamId}

string

required

—

string (enum: true|false)

cURL

curl -X DELETE "https://api.orbit.devotel.io/api/v1/email/streams/{streamId}" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/streams/{streamId}', {
  method: 'DELETE',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": {
    "id": "esend_9f3ab2d61c4a",
    "domain": "mail.acme.com",
    "default_from_email": "offers@acme.com",
    "default_from_name": "Acme Offers",
    "default_reply_to": "support@acme.com",
    "isDefault": true,
    "streamId": null
  },
  "meta": {
    "request_id": "req_send_upd",
    "timestamp": "2026-08-01T12:05:00.000Z"
  }
}

Delete suppressions

DELETE /api/v1/email/suppressions/{id}

string

required

—

string (enum: true|false)

cURL

curl -X DELETE "https://api.orbit.devotel.io/api/v1/email/suppressions/num_8fb2d1b7c00c4ec9a1d3f5e7b9c1d3" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/email/suppressions/num_8fb2d1b7c00c4ec9a1d3f5e7b9c1d3', {
  method: 'DELETE',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": {
    "id": "esend_9f3ab2d61c4a",
    "domain": "mail.acme.com",
    "default_from_email": "offers@acme.com",
    "default_from_name": "Acme Offers",
    "default_reply_to": "support@acme.com",
    "isDefault": true,
    "streamId": null
  },
  "meta": {
    "request_id": "req_send_upd",
    "timestamp": "2026-08-01T12:05:00.000Z"
  }
}

​Email API

​title: “Worked email lifecycle samples” description: “Worked request and response samples for the email senders lifecycle: register a sender, verify the domain’s DNS records, run a test-send, manage suppressions, and validate recipients.”

​Worked email lifecycle samples

​1. Register a sender

​2. Update the sender’s defaults

​3. Promote a sender to the org default

​4. Check the domain’s DNS records

​5. Run a test-send and poll the result

​6. Validate recipient addresses

​7. Manage the suppression list

​8. Poll readiness and DNS, then promote to default

​Warmup, dedicated IP, TLS reports, and inbound routing (advanced)

​Dedicated sending — eligibility, request, status

​TLS-report and Postmaster reputation reads

​See also

​Get dedicated sending status

​Check dedicated IP eligibility

​List sending domains

​Get domains

​Get domain DNS verification history

​Check domain DNS records

​Get domain inbox placement rate

​Get test email send result

​List inbound email routes

​List email senders

​Get one email sender

​List streams

​List suppressed email addresses

​Export suppression list as CSV

​Get sender-reputation summary

​One-click email unsubscribe

​Check batch send against warmup headroom

​Get IP warmup ramp plan

​Get live IP warmup status

​Request a dedicated sending IP

​Analyze reports

​Configure BIMI brand logo

​Create mta-sts

​Initiate a test email send

​Register an inbound email route

​Analyze Google Postmaster Tools + feedback-loop reputation data

​Senders email

​Create set-default

​Streams email

​Create set-default

​Suppressions email

​Bulk-import suppressions

​Analyze TLS-RPT aggregate reports

​One-click email unsubscribe

​Validate a recipient email address

​Bulk-validate recipient email addresses

​Update senders

​Update streams

​Delete an inbound email route

​Delete senders

​Delete streams

​Delete suppressions

Email API

title: “Worked email lifecycle samples” description: “Worked request and response samples for the email senders lifecycle: register a sender, verify the domain’s DNS records, run a test-send, manage suppressions, and validate recipients.”

Worked email lifecycle samples

1. Register a sender

2. Update the sender’s defaults

3. Promote a sender to the org default

4. Check the domain’s DNS records

5. Run a test-send and poll the result

6. Validate recipient addresses

7. Manage the suppression list

8. Poll readiness and DNS, then promote to default

Warmup, dedicated IP, TLS reports, and inbound routing (advanced)

Dedicated sending — eligibility, request, status

TLS-report and Postmaster reputation reads

See also

Get dedicated sending status

Check dedicated IP eligibility

List sending domains

Get domains

Get domain DNS verification history

Check domain DNS records

Get domain inbox placement rate

Get test email send result

List inbound email routes

List email senders

Get one email sender

List streams

List suppressed email addresses

Export suppression list as CSV

Get sender-reputation summary

One-click email unsubscribe

Check batch send against warmup headroom

Get IP warmup ramp plan

Get live IP warmup status

Request a dedicated sending IP

Analyze reports

Configure BIMI brand logo

Create mta-sts

Initiate a test email send

Register an inbound email route

Analyze Google Postmaster Tools + feedback-loop reputation data

Senders email

Create set-default

Streams email

Create set-default

Suppressions email

Bulk-import suppressions

Analyze TLS-RPT aggregate reports

One-click email unsubscribe

Validate a recipient email address

Bulk-validate recipient email addresses

Update senders

Update streams

Delete an inbound email route

Delete senders

Delete streams

Delete suppressions