Retry email domain setup

Changed on

<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

Request

  • Base URL: https://app.base44.com
  • URL: https://app.base44.com/api/apps/{app_id}/custom-email-domains/configure
  • Auth: HTTP bearer

Path parameters

app_idstring required

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

Query parameters

domainstring

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

  • c23775445de2Revision changes
    • breaking

      query request parameter domain list-of-types was narrowed by removing types null

    • info

      for the query request parameter domain, the type was generalized from no type to string

  • 5e139db2e643Revision changes
    • info

      the endpoint scheme security PersonalAccessTokenAuth was added to the API