---
title: "Create a thirty-day pro inbox for $5.00 (x402 USDC on Base mainnet or Stripe MPP)"
method: POST
path: "/api/v1/inboxes/pro"
tags: ["Inboxes"]
---

# Create a thirty-day pro inbox for $5.00 (x402 USDC on Base mainnet or Stripe MPP)

`POST /api/v1/inboxes/pro`

## Request

- Base URL: `https://machineinbox.com`
- URL: `https://machineinbox.com/api/v1/inboxes/pro`
- Auth: none required

Path-priced route for the pro tier: the x402 route table carries one static price per path, and the same path resolves the pro product for Stripe MPP. Equivalent for MPP buyers: POST /api/v1/inboxes with {"product":"pro_inbox"}.

## Headers

- `Idempotency-Key` string

## Request body

- object

## Response `201`

Pro inbox created. The bearer token is returned once; authenticated replies are included.

- CreateInboxResponse
  - `inbox` Mailbox, required
    - `id` string, uuid, required
    - `address` string, email, required
    - `status` 'pending_payment' | 'active' | 'deleted' | 'expired' | 'suspended' | 'payment_failed', required
    - `product` 'seven_day_inbox' | 'pro_inbox' | 'verification_inbox', required
    - `createdAt` string, date-time, required
    - `expiresAt` string, date-time, required
    - `limits` object, required
      - `messages` integer, required
      - `storageBytes` integer, required
    - `usage` object, required
      - `messages` integer, required
      - `storageBytes` integer, required
  - `token` string, required: Returned only on creation or an idempotent replay.
  - `tokenNotice` string, required
  - `replayed` boolean, required

## Other responses

- `400`: The request is malformed.
- `402`: Payment is required. The one 402 advertises both rails: Stripe MPP in WWW-Authenticate and x402 v2 in PAYMENT-REQUIRED. Pay with either.
- `409`: The idempotency key was already used for another operation.
- `429`: A request or reply limit was reached.
- `503`: This operation is temporarily disabled.

---

[API](https://skmtc.dev/machineinbox/apis/machine-inbox-api.md) · [All operations](https://skmtc.dev/machineinbox/apis/machine-inbox-api/llms.txt) · [OpenAPI document](https://skmtc.dev/machineinbox/apis/machine-inbox-api/revisions/bcb3cf08ad6d?raw)
