Create Domain | PostNuvia

{
  "domain_id": "domain_id",
  "domain": "domain",
  "status": "NOT_STARTED",
  "feedback_enabled": true,
  "subdomains_enabled": true,
  "tracking_enabled": true,
  "records": [
    {
      "type": "TXT",
      "name": "name",
      "value": "value",
      "status": "MISSING",
      "priority": 1,
      "reason": "reason"
    },
    {
      "type": "TXT",
      "name": "name",
      "value": "value",
      "status": "MISSING",
      "priority": 1,
      "reason": "reason"
    }
  ],
  "updated_at": "2024-01-15T09:30:00Z",
  "created_at": "2024-01-15T09:30:00Z",
  "pod_id": "pod_id",
  "reason": "reason",
  "inbound_enabled": true,
  "client_id": "client_id"
}

CLI:

postnuvia domains create --domain example.com

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

domainstringRequired

The name of the domain (e.g., example.com).

allow_conflicting_providerbooleanOptional

Allow registration when the domain already has Google Workspace MX records. Defaults to false; registration otherwise returns 422 when a conflicting provider is detected. This flag does not configure DNS or inbound routing. For shared Google Workspace domains, follow the Google Workspace guide. Only checked when inbound_enabled is true; a send-only domain skips the check.

feedback_enabledbooleanOptional

Bounce and complaint notifications are sent to your inboxes.

inbound_enabledbooleanOptional

Receive email for this domain. Defaults to true. Set false for a send-only domain: the apex MX record is not required and is omitted from records, so the domain's existing email provider keeps receiving its mail. Inboxes on a send-only domain can still send.

subdomains_enabledbooleanOptional

Allow inboxes on any subdomain of this domain. Adds a required wildcard MX record (*.<domain>) to records.

tracking_enabledbooleanOptional

Serve open tracking pixels from this domain. Adds a required link.<domain> CNAME record to records, which must be published and verified before track_opens can be used on a send.

Response

This endpoint returns an object.

domain_idstring

The ID of the domain.

domainstring

The name of the domain (e.g., example.com).

statusenum

The verification status of the domain.

feedback_enabledboolean

Bounce and complaint notifications are sent to your inboxes.

subdomains_enabledboolean

Allow inboxes on any subdomain of this domain. Adds a required wildcard MX record (*.<domain>) to records.

tracking_enabledboolean

Serve open tracking pixels from this domain. Adds a required link.<domain> CNAME record to records, which must be published and verified before track_opens can be used on a send.

recordslist of objects

A list of DNS records required to verify the domain. Includes the apex MX record unless inbound_enabled is false, and a wildcard MX record (*.<domain>) when subdomains_enabled is true.

updated_atdatetime

Time at which the domain was last updated.

created_atdatetime

Time at which the domain was created.

pod_idstringOptional

ID of pod.

reasonstringOptional

Why the domain is not (yet) VERIFIED, when known. dns_records_missing / dns_records_invalid point at the DNS records. The ses_* values mean the records look right and sending-infrastructure validation has not converged: ses_dkim_pending / ses_mail_from_pending (still checking), ses_dkim_temporary_failure / ses_mail_from_temporary_failure (a transient error the infrastructure keeps retrying on its own — usually resolves without changes), ses_dkim_failed / ses_mail_from_failed (a terminal verdict; re-verify after fixing), ses_dkim_not_started / ses_mail_from_not_started (the attribute was never configured on the identity — re-verify to push it), and ses_not_verified_for_sending. Absent when VERIFIED.

inbound_enabledbooleanOptional

Absent on domains created before this field existed; those receive email.

client_idstringOptional

Client ID of domain.

Errors

400

Validation Error

422

Unprocessable Error