Domains

You must verify at least one domain before sending live emails. Verification proves you own the domain and configures DKIM, SPF, and DMARC records.

---

Add domain

POST /v1/domains

Requires full_access scope.

Request body

{
  "name": "acme.com"
}

Field	Type	Required	Description
name	string	Yes	Fully qualified domain name.

Response

{
  "id": "dom_abc123",
  "name": "acme.com",
  "status": "pending",
  "dns_records": [
    {
      "type": "TXT",
      "host": "_dmarc.acme.com",
      "value": "v=DMARC1; p=none; rua=mailto:dmarc@acme.com",
      "name": "DMARC",
      "verified": false
    },
    {
      "type": "TXT",
      "host": "sendr._domainkey.acme.com",
      "value": "v=DKIM1; k=rsa; p=MIGfMA0...",
      "name": "DKIM",
      "verified": false
    },
    {
      "type": "TXT",
      "host": "acme.com",
      "value": "v=spf1 include:spf.sendr.dev ~all",
      "name": "SPF",
      "verified": false
    }
  ],
  "created_at": "2025-03-12T09:00:00Z"
}

Add all three DNS records to your DNS provider, then call Verify domain.

---

Verify domain

POST /v1/domains/:id/verify

Requires full_access scope. Checks all DNS records and updates the domain status.

Response

{
  "id": "dom_abc123",
  "name": "acme.com",
  "status": "verified",
  "spf_verified": true,
  "dkim_verified": true,
  "dmarc_verified": true
}

Status values: pending, verified, failed

If some records are not yet propagated, the status remains pending. Wait a few minutes and verify again — DNS propagation typically takes 2–10 minutes but can take up to 48 hours.

---

Get domain

GET /v1/domains/:id

Requires read_only scope.

Returns the full domain object including DNS records and their current verification status.

---

List domains

GET /v1/domains

Requires read_only scope.

Query parameters

Parameter	Type	Default	Description
limit	number	50	Results per page (1–100).
cursor	string		Pagination cursor.

Response

{
  "data": [
    {
      "id": "dom_abc123",
      "name": "acme.com",
      "status": "verified",
      "dns_records": [...],
      "created_at": "2025-03-12T09:00:00Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

---

Delete domain

DELETE /v1/domains/:id

Requires full_access scope. Deletes the domain and all associated DNS configuration. Emails from this domain will fail after deletion.

---

DNS records explained

Record	Purpose
SPF	Authorizes Sendr's servers to send mail on behalf of your domain
DKIM	Cryptographically signs outgoing emails to prevent spoofing
DMARC	Policy for handling SPF/DKIM failures; enables reporting

All three records must be verified for reliable deliverability.

BIMI support

Pro and higher plans support BIMI (Brand Indicators for Message Identification), which displays your logo in supporting email clients. BIMI requires a verified DMARC record with p=quarantine or p=reject policy.

See the Domain Setup guide for step-by-step DNS instructions.