Create Email Domain

Provision a sending domain for a workspace. Find-or-create: returns 200 with the existing record if a domain with this name already exists for the workspace, or 201 with freshly generated DNS records if it was just created. These are email sending domains (DKIM/SPF/DMARC) - for website/hosting domains, see listDomains. The response includes the email-transport records; dkim_record can be null until the DKIM key finishes generating, and POSTing the same name again retries provisioning. Provisioning also creates a no-reply@<name> sender address on the new domain. When accessing the API through an OAuth connection from a third-party platform, this endpoint is restricted to trusted developer platforms; with your own API key (or an OAuth app acting on its own team's workspaces) it always passes. Follow next_steps, which distinguishes the required ownership step, the required transport records, and the recommended return-path record; verified SMTP replaces DKIM/SPF/DMARC. Ownership (ownership_verified) is proved by connecting the domain, as www.example.com or another subdomain of it, to this workspace as a website/hosting domain in the ClickFunnels app, not through this API. Ownership is confirmed at the root domain, so provision example.com rather than a subdomain such as mail.example.com, which is rejected with 422 naming the root domain to use instead. Then call verifyEmailsDomains until ready_for_sending is true; a 200 there means the check ran, not that it passed. The top-level verified field means transport only; sender readiness requires both ownership and transport. Return-path verification is independent. Once ready, create addresses via POST /workspaces/{workspace_id}/emails/addresses with emails_domain_id set to this domain's numeric id.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
Body Params

Information about the sending domain to provision

emails_domain
object
required

A sending domain to provision for a workspace.

Responses

Language
Credentials
Bearer
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json