---
title: "Retry email domain setup"
method: POST
path: "/api/apps/{app_id}/custom-email-domains/configure"
---

# Retry email domain setup

`POST /api/apps/{app_id}/custom-email-domains/configure`

<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](/api-reference/enable-email-sending-for-a-domain) instead.

## Path parameters

- `app_id` string, required — ID of the app whose email domains you want to work with.

## Query parameters

- `domain` string, nullable — Domain to configure. Required when multiple domains exist.

## Response `200`

Where setup stands after the retry.

- ConfigureEmailResponse — Response for email domain configuration.
  - `domain` string, required — The domain that was retried.
  - `configuration_status` string, 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_check` string, 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.

## Other responses

- `400` — This app has more than one email domain and you didn't say which to act on. Send `domain`.
- `401` — Missing or invalid credentials.
- `403` — You don't have access to this app, you used a workspace API key, or the email domain is suspended. A suspended domain says why in the message.
- `404` — This app has no email domain set up, or none matching the `domain` you sent.
- `412` — There's nothing to retry. The domain already sends, or it was never set up.
- `429` — Rate limit exceeded. The base limit is 5 requests per minute. See [Rate limits](/developers/references/app-management/get-started/rate-limits) for the multiplier your plan gets.

---

[API](https://skmtc.dev/base44/apis/base44-app-management-api.md) · [All operations](https://skmtc.dev/base44/apis/base44-app-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/base44/base44-app-management-api/revisions/173e4e9c63c2/schema)