Add a destination to verify

POST

https://api.inboxkit.com/v1/api/verified-domains

Maintainer:Not configured

Add a website you want to mask your domains to. The response includes a TXT record. Publish it at your DNS provider to prove you own the website.

You can send a domain or a full URL. Only the root domain is kept, so https://www.example.com/pricing becomes example.com. Verifying the root domain also covers its subdomains.

If the website is already on your list, you get the existing entry and the same TXT record.

Next steps

Publish data.txt_record at your DNS provider.

Call Verify a destination with data.uid.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params application/jsonRequired

Examples

Responses

🟢201Created

application/json

The destination and the TXT record to publish. Also returned when the website is already on your list.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.inboxkit.com/v1/api/verified-domains' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "domain": "example.com"
}'

Response Example

201 - Website added

{
    "success": true,
    "data": {
        "uid": "5b1f7c2e-8a4d-4f3b-9c6e-2d7a1b0e9f43",
        "domain": "example.com",
        "status": "pending",
        "is_grandfathered": false,
        "verified_at": null,
        "last_checked_at": null,
        "last_error": "",
        "created_at": "2026-09-26T10:00:00.000Z",
        "txt_record": {
            "type": "TXT",
            "name": "_inboxkit-verify.example.com",
            "value": "inboxkit-verify=3f9c2a7b1e4d4c0f9a8b6d5e2c1f0a9b"
        }
    }
}

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

List verified destinations

Verify a destination