Sending domains

Add and authenticate the domains you send from. For the step-by-step DNS walkthrough, see the Set up a sending domain guide. Paths are relative to https://app.blacklistguard.com/api/v1.

List & create

GET    /sending-domains
POST   /sending-domains
DELETE /sending-domains/{id}

List returns [{ id, domain, is_verified, spf_verified, dkim_verified, verified_at, is_active, created_at }]. Create with { "domain": "send.yourdomain.com" } → { id }. A DKIM key is generated automatically on create, so the DKIM record is ready immediately.

Get DNS records & status

GET /sending-domains/{id}/dns-status

Returns everything you need to publish and check the domain's DNS: the ownership verification_token, the SPF include domain (platform_spf_domain), and a dns object with the live status and record values for ownership, SPF, DKIM (dkim_selector, dkim_public_key, dkim_record), and DMARC (dmarc_suggested, dmarc_record).

Verify

POST /sending-domains/{id}/verify

Runs a live DNS check and returns { ownership_verified, spf_verified, dkim_verified, dmarc_verified, verified }. Ownership must pass for the domain to be usable; SPF/DKIM/DMARC are reported alongside.

Bounce & DMARC-report options

PATCH /sending-domains/{id}/custom-return-path   { "enabled": true }
PATCH /sending-domains/{id}/dmarc-ingestion       { "enabled": true }

Enable a custom Return-Path (handle bounces on your own subdomain) or DMARC report ingestion. Each adds DNS records, returned by dns-status once enabled.

Verified senders

If you can't add DNS records, authorize a single From address by email confirmation instead.

GET    /verified-senders
POST   /verified-senders          { "email": "...", "from_name": "..." }
POST   /verified-senders/{id}/resend
DELETE /verified-senders/{id}

Creating one emails a confirmation link to the address; once clicked, it's verified. List returns [{ id, email, from_name, is_verified, verified_at, token_expires_at, created_at }].