Add a domain

Register a domain you own so you can send from your own brand. The response carries the exact DNS records to publish; once they resolve, call verify. POST /v1/domains Creating a domain returns it in pending status along with a records array — DKIM (a CNAME), SPF, and DMARC (both TXT). Publish all of them at your DNS provider, then verify to flip the domain to verified.

Body

string

required

The fully-qualified domain or subdomain to send from, for example mail.acme.com. A subdomain dedicated to sending is recommended so DMARC policy on your root domain is untouched.

Account-wide keys may name the owning project with the X-Drin-Product header; project-scoped keys omit it. See Authentication.

Request

curl https://api.drin.run/v1/domains \
  -H "Authorization: Bearer $DRIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "domain": "mail.acme.com" }'

import { DrinClient } from "@drin00/sdk";

const drin = new DrinClient({ apiKey: process.env.DRIN_API_KEY });

const domain = await drin.domains.create({ domain: "mail.acme.com" });

// Publish each record at your DNS provider, then call verify.
for (const record of domain.records) {
  console.log(record.type, record.name, record.value);
}

import os, requests

r = requests.post(
    "https://api.drin.run/v1/domains",
    headers={"Authorization": f"Bearer {os.environ['DRIN_API_KEY']}"},
    json={"domain": "mail.acme.com"},
)
print(r.json())

Response

201 Created — the domain plus the records to publish. Each record carries a purpose (dkim, spf, dmarc) and a verified flag that stays false until the record resolves.

{
  "id": "dom_01HZ8K3M9P",
  "domain": "mail.acme.com",
  "status": "pending",
  "records": [
    {
      "type": "CNAME",
      "name": "abcd1234._domainkey.mail.acme.com",
      "value": "abcd1234.dkim.drin.run",
      "purpose": "dkim",
      "verified": false
    },
    {
      "type": "TXT",
      "name": "mail.acme.com",
      "value": "v=spf1 include:drin.run ~all",
      "purpose": "spf",
      "verified": false
    },
    {
      "type": "TXT",
      "name": "_dmarc.mail.acme.com",
      "value": "v=DMARC1; p=none;",
      "purpose": "dmarc",
      "verified": false
    }
  ]
}

No DNS yet? You can send from a shared onboarding domain in test mode without adding a domain at all — it just can only deliver to your own address. See the Quickstart.

Overview

Emails

Domains

Inboxes

Threads

Inbound

Webhooks

Suppressions

Contacts

Templates

Metrics

API keys

Add a domain

Body

Request

Response

​Body

​Request

​Response

Body

Request

Response