---
title: "Create Mailbox Order Intent"
method: POST
path: "/api/billing-intents/mailbox-order"
tags: ["billing-intents"]
---

# Create Mailbox Order Intent

`POST /api/billing-intents/mailbox-order`

## Request

- Base URL: `https://platform.verbiflow.com/api/bridge`
- URL: `https://platform.verbiflow.com/api/bridge/api/billing-intents/mailbox-order`
- Auth: one of:
  - HTTP bearer and API key in header `x-flage-org-id`
  - HTTP bearer and API key in header `x-flage-org-slug`

## Request body

- CreateMailboxOrderIntentRequest
  - `domain` string, required
  - `is_new_domain` boolean, required
  - `mailboxes` MailboxOrderIntentItem[], required
    - `email` string, required
    - `first_name` string, required
    - `last_name` string, required
    - `platform` 'GOOGLE' | 'MICROSOFT'
    - `profile_pic_url` string, nullable
    - `sender_id` string, nullable
  - `registration_years` integer
  - `request_id` string, uuid, required

## Response `201`

Successful Response

- CreateMailboxOrderIntentResponse
  - `intents` IntentSummary[], required
    - `intent_id` string, required: Durable billing/provisioning intent id.
    - `kind` 'domain_purchase' | 'mailbox_purchase', required: Domain registration or mailbox provisioning admitted for this order item.
    - `status` 'pending' | 'awaiting_customer' | 'provisioning' | 'provisioned' | 'provision_failed' | 'reconciled' | 'canceled', required
  - `order_group_id` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract.md) - [All operations](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/llms.txt) - [OpenAPI document](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/revisions/c80e903ef8f3?raw)