---
title: "Create Order Intent"
method: POST
path: "/unstable/order-intents"
tags: ["Order Intents"]
---

# Create Order Intent

`POST /unstable/order-intents`

Create a new order intent.

**API scope required**: `order-intents.create`

## Headers

- `X-API-KEY` string, required

## Request body

- CreateOrderIntentInputDto
  - `agentId` string, required
  - `payment` object, required
    - `paymentMethodId` string
  - `mandates` union[], required
    - union
      - object
        - `type` 'maxAmount', required
        - `value` string, required
        - `details` object, required
          - `currency` 'usd' | 'eur' | 'aud' | 'gbp' | 'jpy' | 'sgd' | 'hkd' | 'krw' | 'inr' | 'vnd' | 'cop' | 'mxn', required
          - `period` 'weekly' | 'monthly' | 'yearly'
      - object
        - `type` 'consumer', required
        - `details` object, required
          - `email` string, email, required
      - object
        - `type` 'description', required
        - `value` string, required
      - object
        - `type` 'prompt', required
        - `value` string, required
  - `expiresAt` string, date-time

## Response `201`

The order intent has been successfully created

- union
  - object
    - `orderIntentId` string, required
    - `agentId` string, required
    - `mandates` union[], required
      - union
        - object
          - `type` 'maxAmount', required
          - `value` string, required
          - `details` object, required
            - `currency` 'usd' | 'eur' | 'aud' | 'gbp' | 'jpy' | 'sgd' | 'hkd' | 'krw' | 'inr' | 'vnd' | 'cop' | 'mxn', required
            - `period` 'weekly' | 'monthly' | 'yearly'
        - object
          - `type` 'consumer', required
          - `details` object, required
            - `email` string, email, required
        - object
          - `type` 'description', required
          - `value` string, required
        - object
          - `type` 'prompt', required
          - `value` string, required
    - `payment` object, required
      - `paymentMethodId` string, required
    - `phase` 'requires-verification', required
    - `verificationConfig` object, required
      - `environment` 'production' | 'test', required
      - `publicApiKey` string, required
      - `agentId` string, required
      - `instructionId` string, required
  - object
    - `orderIntentId` string, required
    - `agentId` string, required
    - `mandates` union[], required
      - union
        - object
          - `type` 'maxAmount', required
          - `value` string, required
          - `details` object, required
            - `currency` 'usd' | 'eur' | 'aud' | 'gbp' | 'jpy' | 'sgd' | 'hkd' | 'krw' | 'inr' | 'vnd' | 'cop' | 'mxn', required
            - `period` 'weekly' | 'monthly' | 'yearly'
        - object
          - `type` 'consumer', required
          - `details` object, required
            - `email` string, email, required
        - object
          - `type` 'description', required
          - `value` string, required
        - object
          - `type` 'prompt', required
          - `value` string, required
    - `payment` object, required
      - `paymentMethodId` string, required
    - `phase` 'requires-payment-method' | 'active' | 'expired' | 'revoked', required

---

[API](https://skmtc.net/crossmint/apis/onramp.md) · [All operations](https://skmtc.net/crossmint/apis/onramp/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/crossmint/onramp/revisions/e2143d192130/schema)