Skip to content

Create a domain

POST /v1/domains

Request body

FieldTypeRequiredNotes
domainstringYesBare domain, e.g. paylink.ng. No scheme, no path.

Response 201

{
"id": "0d1f...",
"domain": "paylink.ng",
"status": "pending",
"dkim_selector": "sb",
"dns_records": [
{ "type": "TXT", "host": "paylink.ng", "value": "v=spf1 include:spf.sendbyte.africa ~all", "purpose": "spf", "required": true },
{ "type": "TXT", "host": "sb._domainkey.paylink.ng", "value": "v=DKIM1; k=rsa; p=MIIB...", "purpose": "dkim", "required": true },
{ "type": "TXT", "host": "_dmarc.paylink.ng", "value": "v=DMARC1; p=none; rua=mailto:dmarc@sendbyte.africa", "purpose": "dmarc", "required": false }
],
"verified_at": null,
"created_at": "..."
}

A unique DKIM keypair is generated per domain; the private key never leaves SendByte. Creating a domain that already exists in your project returns 200 with the existing record. Also available: GET /v1/domains and GET /v1/domains/{id}.