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 Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.inboxkit.com/v1/api/domains/register' \
--header 'X-Workspace-Id;' \
--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"
    ]
}

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

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

Check domain availability

List domains