Create a domain (and generate verification DNS records)

POST

/v1/domains

Creates (or returns existing) domain and attaches DNS verification instructions.
Response omits internal id / account_id and does not expose dashboard credit fields.

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

🟢200

application/json

Created domain resource

Bodyapplication/json

🟠401

🟠422

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.arsel.ai/api/v1/domains' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "name": "string"
}'

Response Example

200 - Example 1

{
    "uuid": "string",
    "name": "string",
    "region": "string",
    "dkim_selector": "string",
    "verified_at": "string",
    "verification_status": "pending",
    "verification_instructions_json": {
        "property1": "string",
        "property2": "string"
    },
    "warmup_status": "not_started",
    "is_warmed": true,
    "warmup_score": 0,
    "warmup_started_at": "string",
    "warmup_paused_at": "string",
    "warmup_completed_at": "string",
    "created_at": "string",
    "updated_at": "string"
}

List domains

Delete a domain