Sender domains and DNS

​

Goal

​

Prerequisites

• DNS control for the sender domain
• A StackShift API key

​

Workflow

​

Domain API

const domain = await stackshift.mail.domains.create('example.com')

for (const record of domain.records ?? []) {
  console.log(record.type, record.name, record.value, record.status, record.required)
}

const checked = await stackshift.mail.domains.verify(domain.id)
console.log(checked.status, checked.spfStatus, checked.dkimStatus, checked.dmarcStatus, checked.returnPathStatus)

​

Status fields

• domain.status is pending, verified, failed, or disabled.
• spfStatus, dkimStatus, dmarcStatus, and returnPathStatus are missing, pending, verified, or failed.
• records contains DNS records with type, name, value, status, required, and optional explanation.
• Deleting a domain removes it from the StackShift sender-domain registry. It does not delete DNS records at your DNS provider.

​

Record types currently surfaced

• TXT records are used for SPF or DMARC-style policy data.
• CNAME records are used for delegated verification or return-path style routing.
• MX records are used where mail routing requires them, especially inbound domain workflows.

​

Expected result

​

Common failures

​

Related guides