Place Order

POST

https://api.inboxkit.com/v1/api/orders

Maintainer:Not configured

Order new domains and their mailboxes in one request. For each domain we register it, create its mailboxes and forward it to its redirect_url.

The response lists every domain with its result. Accepted domains are set up after the call returns. Rejected domains include the reason in message.

Forwarding

Each domain forwards visitors to its redirect_url with a standard redirect.

URL masking is not available on orders. To mask a domain, turn masking on for it once it is active.

Warmup

Set warmup_addon_enabled to true to add warmup to every mailbox in the order.

The first month of warmup is charged to your wallet when the order is placed. Warmup starts automatically once each mailbox is ready and renews monthly from the day it starts.

Your wallet must cover the order and the first month of warmup, otherwise the order is not placed.

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

🟢201Created

application/json

Bodyapplication/json

🟠400Bad Request

🟠402Payment Required

Request Example

Shell

JavaScript

Java

Swift

cURL

ExampleOrder with warmup

curl --location 'https://api.inboxkit.com/v1/api/orders' \
--header 'X-Workspace-Id: <YOUR_WORKSPACE_UID>' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "contact_details": {
        "first_name": "Okey",
        "last_name": "DuBuque",
        "email": "[email protected]",
        "phone": "(594) 797-0083",
        "organization": "ipsum laborum eiusmod culpa tempor",
        "address_line1": "incididunt sunt minim",
        "address_line2": "laborum do tempor",
        "city": "Shannonview",
        "state": "Oregon",
        "country": "Japan",
        "postal_code": "96538"
    },
    "domains": [
        {
            "name": "nvMtjDvpU.czlZucODdDv",
            "redirect_url": "https://cultivated-hydrolyze.net/",
            "registration_years": 5,
            "contact_details": {
                "first_name": "Octavia",
                "last_name": "Rippin",
                "email": "[email protected]",
                "phone": "(520) 495-3049",
                "organization": "do ipsum laboris",
                "address_line1": "culpa irure",
                "address_line2": "velit non cupidatat",
                "city": "Johnstonbury",
                "state": "Massachusetts",
                "country": "Poland",
                "postal_code": "21658-6550"
            },
            "mailboxes": [
                {
                    "email": "[email protected]",
                    "first_name": "Mattie",
                    "last_name": "Doyle",
                    "platform": "GOOGLE",
                    "sequencer_uid": "22",
                    "profile_pic_url": "https://loremflickr.com/400/400?lock=6875166819662371"
                }
            ]
        }
    ]
}'

Response Example

201 - Domain accepted

[
    {
        "order_id": "ord_1234567890",
        "status": "mydomain.com queued",
        "domain": "mydomain.com",
        "platform": "GOOGLE",
        "mailboxes": [
            "[email protected]",
            "[email protected]"
        ],
        "registration_years": 2
    }
]

Modified at 2026-09-28 15:38:58

Deliverability Monitoring

Events: OAuth Consent & Client ID Changes