Get nameservers for domain connection

POST

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

Maintainer:Not configured

Connect domains you already own to your workspace and get the nameservers for each one.

Next steps

Set the returned nameservers at your domain registrar.

Follow progress with Check nameservers propagation. The domain shows as not_connected until the new nameservers are live.

If the nameservers are not live within 12 hours, the domain moves to expired_propagation. Call Regenerate Domain Nameservers to get new ones.

A domain that is already connected to your workspace returns 409 with its current nameservers.

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

Domains connected. Set the returned nameservers at your registrar.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.inboxkit.com/v1/api/domains/nameservers' \
--header 'X-Workspace-Id;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "domains": [
        "example.com"
    ],
    "mask_forwarding": true
}'

Response Example

{
    "error": false,
    "message": "Nameservers created successfully",
    "result": [
        {
            "domain": "example.com",
            "nameservers": [
                "ns1.example-dns.net",
                "ns2.example-dns.net"
            ],
            "uid": "string"
        }
    ]
}

Modified at 2026-09-26 15:03:15

Remove catch-all email

Check nameservers propagation