Create a done-for-you order

Orders domains and pre-warmed mailboxes for the caller's workspace. The order is accepted and provisioned asynchronously; poll GET /dfy/orders/{id} for progress.

This call buys domains and charges the card, and it can take longer than the connection is held open — a timeout or a 502 does NOT mean the order failed. Send an Idempotency-Key header and repeat the identical request to find out: a repeat of a key that already placed an order returns that order instead of buying anything again. Reuse the key to retry safely; use a NEW key only when you intend a genuinely different order.

Without a key the order is still checked against the workspace's live orders, and one that would buy a domain or a mailbox address already bought is refused with 409 and the id of the order that has it.

post/dfy/orders

Request

Base URL: https://api.emailchaser.com/r
URL: https://api.emailchaser.com/r/dfy/orders
Auth: HTTP bearer

Headers

Idempotency-Keystring

Repeat this key to retry the same order safely (max 255 characters)

Request body

forwardingDomainstring

ForwardingDomain is where the purchased domains redirect visitors.

Example request

{
  "domains": [
    {
      "domainName": "acme-mail.com"
    }
  ],
  "forwardingDomain": "acme.com",
  "mailboxes": [
    {
      "domainName": "acme-mail.com",
      "firstName": "John",
      "lastName": "Doe",
      "username": "john"
    }
  ]
}

Response

The accepted order, or the order a previous attempt with the same Idempotency-Key already placed

Example response

{
  "order": {
    "completedAt": "2026-07-01T10:35:00Z",
    "createdAt": "2026-07-01T10:30:00Z",
    "externalOrderId": "cmr_order_456",
    "id": 9,
    "processedAt": "2026-07-01T10:30:00Z",
    "status": "created"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.