Retry email domain setup

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Retries setup for a domain that stalled, and reports where it got to.

What it retries depends on where the domain stopped:

A domain waiting on DNS gets its records written again when Base44 controls them, or is reset so you can publish them yourself.
A domain whose provider registration failed is registered again.
A domain waiting on verification is checked again.

The active and not_configured statuses can't be retried. There's nothing to retry on a domain that already sends, and one that was never set up needs Enable email sending for a domain instead.

post/api/apps/{app_id}/custom-email-domains/configure

Path parameters

app_idstring required

ID of the app whose email domains you want to work with.

Query parameters

domainstring nullable

Domain to configure. Required when multiple domains exist.

Response

Where setup stands after the retry.

domainstring required

The domain that was retried.

configuration_statusstring required

Where setup stands after the retry. Only active sends mail. A retry starts the next step rather than finishing it, so this is often still a pending_ value, meaning setup is in progress. The failed_ values mean it stopped and you can try again.

last_checkstring date-time nullable required

When Base44 last checked this domain's records, as a UTC timestamp in ISO 8601 format, or null before the first check.

Example response

{
  "domain": "example.com",
  "configuration_status": "pending_domain_verification",
  "last_check": "2026-08-26T09:12:44"
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.