Submit domains

POST

/domains

Submit up to 45 domains for provisioning. Domains are queued immediately and added to Cloudflare in the background. Returns a dashboardUrl to track NS records and propagation status in real time.

Limit: Maximum 45 domains per request.

NS Records: Visit the dashboardUrl to see NS records per domain once provisioning completes (usually within seconds). Update your nameservers at your registrar to the values shown.

Domain statuses: QUEUED → PENDING_NS → ACTIVE

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢202

application/json

Accepted - domains queued for provisioning

Body

🟠400

🟠401

🔴503

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/domains' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "domains": [
        "yourdomain.com",
        "anotherdomain.com"
    ]
}'

Response Example

{
    "success": true,
    "data": {
        "submitted": 2,
        "batchId": "batch_abc123",
        "status": "queued",
        "dashboardUrl": "https://app.inboxedup.co/portal/domains/batch/batch_abc123",
        "message": "Domains queued for provisioning. Visit dashboardUrl to track NS records and propagation status."
    }
}

Modified at 2026-03-12 08:23:25

Update subscription notes

List domains