ArgorantDocs

Order new mailboxes

posthttps://app.argorant.com/api/v1/inboxes/orders
POST
/api/v1/inboxes/orders

The quote the person said yes to.

Names the mailboxes send as.

Where visitors of the new domains go.

true: the person who pays said yes.

auto or link.

Orders exactly what a quote showed. confirmed: true states that the person who pays said yes to the full quote. When the workspace allows purchases with its saved card, the card is charged within its limits; otherwise you get checkout_url, a payment page the person pays themselves. Nothing is bought before that payment. senders are the people the mailboxes send as.

CostWhat it doesKey scopes
The quoted price, charged only after the person who pays confirmedCharges moneyargorant:manage_lists

Authorization

BearerAuth
AuthorizationBearer <token>

Your API key from app.argorant.com/profile, sent as Authorization: Bearer <key>. A connector sign-in token (ag_mcp_...) works the same way.

In: header

Header Parameters

Idempotency-Key?string

Any unique text up to 128 characters. A retry with the same key and the same body within 24 hours returns the first answer (with the header Idempotent-Replayed: true) instead of doing the work twice. The same key with another body answers 409 idempotency_conflict.

Lengthlength <= 128
X-Request-Id?string

Your own id for this request, 8 to 64 letters, digits, dot, dash or underscore. Returned as X-Request-Id; one is made for you when you send none.

Match^[A-Za-z0-9._-]{8,64}$

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

Shell
curl -X POST "https://app.argorant.com/api/v1/inboxes/orders" \  -H "Idempotency-Key: 6f1c2e7a-run-42" \  -H "Content-Type: application/json" \  -d '{    "quote_id": "5b7e2d4a-1c3f-4e8a-9b6d-0a2c4e6f8b1d",    "senders": [      {        "first_name": "Elena",        "last_name": "Vaughn"      }    ],    "website": "northgate-advisory.com",    "confirmed": true  }'
JSON
{  "order_id": "b345aa96-059d-47e7-b733-c1899f843a00",  "checkout_url": "https://checkout.example.com/pay/cs_live_a1B2c3",  "status": "awaiting_payment",  "existing": false,  "message": "Send this checkout link to the user. Nothing is bought until they pay it; setup starts after the payment is confirmed."}