API reference

DKIM keys

Every sending domain gets a DKIM key automatically when you add it — so most workspaces never touch these endpoints. Use them to generate an extra key or rotate one. Paths are relative to https://app.blacklistguard.com/api/v1.

List keys

GET /dkims

Returns [{ id, domain, selector, public_key, created_at }].

Generate a key

POST /dkims
{ "domain": "send.yourdomain.com", "selector": "default", "bits": 2048 }

selector and bits are optional (default default and 2048). The response includes the DNS record to publish and the generated key. Publish the record, then verify.

Verify DNS

POST /dkims/{id}/verify-dns

Checks that the published DKIM record matches the key.

Remove a key

DELETE /dkims/{id}