API referenceSending Domains
List sending domains
The domains the workspace sends from, by name; of one email provider when given.
GET
The domains the workspace sends from, by name; of one email provider when given.
apiKey readheader
AuthorizationBearer <token>A workspace API key (pf_…), created under Developers → API keys.
Scope: read
emailProviderId?stringFormat
uuidOK
application/json- response
items*array<>curl -X GET 'https://api.postforge.dev/v1/sending-domains'{ "items": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "emailProviderId": "683bf648-54ce-4fc9-9f81-2da7d42459c3", "name": "string", "region": "us-east-1", "status": "not_started", "records": [ { "purpose": "string", "type": "string", "name": "string", "value": "string", "priority": 0, "status": "not_started" } ], "dmarc": { "status": "found", "record": "string", "host": "string", "suggested": "string" }, "senderCount": 0, "checkedAt": "2019-08-24T14:15:22Z", "createdAt": "2019-08-24T14:15:22Z" } ]}Disconnect an email provider POST
Removes the webhook from the account and forgets the key. It stays listed, with the messages sent through it.
Add a sending domain POST
Uses the domain when the account has it, or creates it there; the provider’s own open and click tracking is switched off (Postforge tracks). Answers the DNS records to set and what’s checked.