Register domains

POST

https://api.inboxkit.com/v1/api/domains/register

Maintainer:Not configured

Register domains with contact details and configuration. Supports both new domain creation and updating existing pending payment domains.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Header Params

Body Params application/json

Examples

Responses

🟢200OK

application/json

Domain registration initiated successfully

Body

🟠400Bad Request

🟠401Unauthorized

🟠402402

🟠409409

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.inboxkit.com/v1/api/domains/register' \
--header 'X-Workspace-Id;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "domains": [
        {
            "name": "example.com",
            "registration_years": 2
        }
    ],
    "domain_forwarding_url": "https://example.com",
    "dmarc_email": "[email protected]",
    "enable_mask_forwarding": false,
    "catch_all_email": "[email protected]",
    "use_wallet_balance": false,
    "contact_details": {
        "first_name": "John",
        "last_name": "Doe",
        "email": "[email protected]",
        "phone": "+1234567890",
        "organization": "Acme Corp",
        "address_line1": "123 Main St",
        "address_line2": "Suite 100",
        "city": "New York",
        "state": "NY",
        "country": "US",
        "postal_code": "10001"
    }
}'

Response Example

200 - Wallet

{
    "error": false,
    "message": "Domains registration initiated successfully",
    "domains_count": 2,
    "total_cost": 49.96,
    "payment_type": "wallet",
    "contact_details": {
        "first_name": "Alice",
        "last_name": "Doe",
        "email": "[email protected]",
        "phone": "(997) 416-8688",
        "organization": "incididunt aliqua reprehenderit Duis sint",
        "address_line1": "Alabama Lake Lillieberg Clay County 422 Mill Road Apt. 612",
        "address_line2": "Oregon Brentstad Douglas County 7360 Connelly Crest Apt. 381",
        "city": "Binscester",
        "state": "Arkansas",
        "country": "Egypt",
        "postal_code": "94102-3898"
    },
    "domain_uids": [
        "dom_aaa",
        "dom_bbb"
    ]
}

Modified at 2025-08-16 05:54:29

Check domain availability

List domains