Retry email domain setup

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/custom-email-domains/configure \
  --header 'api_key: <api-key>'

import requests

url = "https://app.base44.com/api/apps/{app_id}/custom-email-domains/configure"

headers = {"api_key": "<api-key>"}

response = requests.post(url, headers=headers)

print(response.text)

const options = {method: 'POST', headers: {api_key: '<api-key>'}};

fetch('https://app.base44.com/api/apps/{app_id}/custom-email-domains/configure', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.base44.com/api/apps/{app_id}/custom-email-domains/configure",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "api_key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.base44.com/api/apps/{app_id}/custom-email-domains/configure"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("api_key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/custom-email-domains/configure")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["api_key"] = '<api-key>'

response = http.request(request)
puts response.read_body

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

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

API Reference

Retry email domain setup

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

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.

active and not_configured cannot be retried and return a 412. There is nothing to retry on a domain that already sends, and one that was never set up needs Enable email sending for a domain instead.

The response carries the status after the attempt, which is often still a pending_ value: a retry starts the next step rather than finishing it. Send domain when the app has more than one.

This endpoint is limited to 5 requests per minute.

configuration_status moves through pending_dns_configuration, pending_user_dns_configuration, pending_domain_verification and then active. The three failed_ values mean setup stopped and you can retry with Retry email domain setup. Only active sends mail.

This endpoint accepts a personal API key. Workspace API keys are not authorized for it and are rejected with a 403.

POST

api

apps

{app_id}

custom-email-domains

configure

Retry email domain setup

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/custom-email-domains/configure \
  --header 'api_key: <api-key>'

import requests

url = "https://app.base44.com/api/apps/{app_id}/custom-email-domains/configure"

headers = {"api_key": "<api-key>"}

response = requests.post(url, headers=headers)

print(response.text)

const options = {method: 'POST', headers: {api_key: '<api-key>'}};

fetch('https://app.base44.com/api/apps/{app_id}/custom-email-domains/configure', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.base44.com/api/apps/{app_id}/custom-email-domains/configure",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "api_key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.base44.com/api/apps/{app_id}/custom-email-domains/configure"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("api_key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/custom-email-domains/configure")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["api_key"] = '<api-key>'

response = http.request(request)
puts response.read_body

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

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

api_key

string

header

required

Personal API key.

Path Parameters

app_id

string

required

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

Query Parameters

domain

string | null

Domain to configure. Required when multiple domains exist.

Response

Where setup stands after the retry.

Response for email domain configuration.

domain

string

required

The domain that was retried.

Example:

"example.com"

configuration_status

string

required

Where setup stands after the retry. Often still a pending_ value, because a retry starts the next step rather than finishing it.

Example:

"pending_domain_verification"

last_check

string<date-time> | null

required

When Base44 last checked this domain's records. null before the first check.

Example:

"2026-08-26T09:12:44Z"

⌘I

App Management API (Beta)

Entities API (Beta)

Virality API (Beta)

Workflows API (Beta)

Analytics API (Beta)

Google Ads API (Beta)

Monitoring API

Audit Logs API

Retry email domain setup

Authorizations

Path Parameters

Query Parameters

Response