Domains

Send from your own domain, authenticated

Add a domain, publish the records we give you and start sending with DKIM, SPF, DMARC and Return-Path aligned. The records come formatted for your DNS panel.

  • JSON commands
  • DKIM 2048
  • Zero-downtime key upgrade
  • Auto-validation
  • Registrar-aware hosts
POSThttps://g.sendcorex.com/v1/domaindomain:*

How it works

Records ready to paste

We detect where your DNS is hosted and write each host the way that panel expects. Long DKIM values also come split for panels that need it.

Validated by itself

Every Get Domain checks the DNS live. The moment the Return-Path and DKIM are found, the domain is validated and you get an email.

Keys that age well

New domains get 2048-bit DKIM. Older 1024-bit keys move to 2048 on a new selector, with the old one signing until the new record is live.

Get started

Only the key is needed before your first request.

  1. 1

    Create an API key with domain scopes

    In the dashboard, open Developers → API Keys and give the key domain:read and domain:create. Add domain:delete only if it really needs to delete.

    The webmail token does not work here. This API uses the dashboard API key.

  2. 2

    Add the domain

    Add Domain creates the DKIM key and returns the records to publish.

  3. 3

    Publish and check

    Create the records in your DNS panel, then call Get Domain until validated is true. After that, create senders on it.

The domain

Add Domain and Get Domain return the domain in this shape.

{
  "domain": "news.acme.com",
  "validated": false,
  "has_mx": false,
  "has_spf": false,
  "has_dkim": false,
  "has_dmarc": false,
  "has_return_path": false,
  "description": null,
  "dkim_key_size": 2048,
  "dkim_deprecated": false,
  "dkim_upgrade_pending": false,
  "created_at": "2026-10-21T03:02:15.441Z",
  "updated_at": "2026-10-21T03:02:15.441Z",
  "registrar": "cloudflare",
  "dns_records": {
    "spf": {
      "type": "TXT",
      "host": "news.acme.com",
      "value": "v=spf1 include:smtp.emailsbit.com ~all"
    },
    "dkim": {
      "type": "TXT",
      "host": "sendcorex._domainkey.news",
      "value": "v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAu1SU1LfVLPHCozMxH2Mo4lgOEePzNm0tRgeLezV6ffAt0gunVTLw7onLRnrq0/IzW7yWR7QkrmBL7jTKEn5u+qKhbwKfBstIs+bMY2Zkp18gnTxKLxoS2tFczGkPLPgizskuemMghRniWaoLcyehkd3qqGElvW/VDL5AaWTg0nLVkjRo9z+40RQzuVaE8AkAFmxZzow3x+VJYKdjykkJ0iT9wCS0DRTXu269V264Vf/3jvredZiKRkgwlL9xNAwxXFg0x/XFw005UWVRIkdgcKWTjpBP2dPwVZ4WWC+9aGVd+Gyn1o0CLelf4rEjGoXbAAEgAqeGUxrcIlbjXfbcmwIDAQAB",
      "split_value": "\"v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAu1SU1LfVLPHCozMxH2Mo4lgOEePzNm0tRgeLezV6ffAt0gunVTLw7onLRnrq0/IzW7yWR7QkrmBL7jTKEn5u+qKhbwKfBstIs+bMY2Zkp18gnTxKLxoS2tFczGkPLPgizskuemMghRniWaoLcyehkd3qqGElvW/VDL5AaWTg0nLVkjRo9z+40RQzuVaE8AkAF\" \"mxZzow3x+VJYKdjykkJ0iT9wCS0DRTXu269V264Vf/3jvredZiKRkgwlL9xNAwxXFg0x/XFw005UWVRIkdgcKWTjpBP2dPwVZ4WWC+9aGVd+Gyn1o0CLelf4rEjGoXbAAEgAqeGUxrcIlbjXfbcmwIDAQAB\""
    },
    "mx": {
      "type": "MX",
      "host": "news.acme.com",
      "value": "bounce.emailsbit.com",
      "priority": 0
    },
    "return_path": {
      "type": "CNAME",
      "host": "bounces.news",
      "value": "bounce.emailsbit.com"
    },
    "dmarc": {
      "type": "TXT",
      "host": "_dmarc.news",
      "value": "v=DMARC1; p=none; rua=mailto:dmarc@bounces.news.acme.com"
    }
  },
  "spf_duplicate": false,
  "spf_duplicate_records": [],
  "dkim": {
    "version": 2,
    "key_size": 2048,
    "selector": "sendcorex",
    "deprecated": false,
    "upgrade_pending": false,
    "pending": null,
    "previous_selector": null,
    "keep_old_record_until": null,
    "just_upgraded": false
  }
}
validated

true once the Return-Path and DKIM records are found. Only validated domains can have senders.

dns_records

SPF, DKIM, MX, Return-Path and DMARC, each with type, host and value. Return-Path and DKIM are the required ones.

registrar

Where your DNS is hosted. It decides if host is relative (Cloudflare, Namecheap…) or the full name (GoDaddy…).

dkim

The key in use, its size and any upgrade in progress.

Your first request

Add a subdomain for your newsletters. Replace SENDCOREX_API_KEY with your API key.

curl -X POST 'https://g.sendcorex.com/v1/domain' \
  -H "Authorization: $SENDCOREX_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "commands": [
    { "command": "add_domain", "args": { "domain": "news.acme.com" } }
  ]
}'

You get the records to publish. Publish them, then call get_domain with the same domain until validated is true. The same request in 8 languages is in Add Domain.

Common tasks

Onboard customers inside your app

Add their domain from your own UI, show the records, and poll Get Domain until it turns green.

Waiting for the DNS

Hand the DNS to someone else

Email the exact records to the IT team or agency that manages the domain.

Send DNS Instructions

Upgrade old 1024-bit keys

Find domains with dkim_deprecated and move them to 2048 bits without a minute of failed DKIM.

How the upgrade works

Send before your domain is ready

Create a sender on a shared domain we already verified, and switch to yours later.

List Free Domains

Full reference

Everything marked CMD is a command sent through POST /v1/domain, up to 10 per request.