---
title: "Create Embeddable Flow"
method: POST
path: "/embeddable_flows"
---

# Create Embeddable Flow

`POST /embeddable_flows`

## Request

- Base URL: `https://app.moderntreasury.com/api`
- URL: `https://app.moderntreasury.com/api/embeddable_flows`
- Auth: HTTP basic

Create an embeddable flow

## Request body

- object
  - `template` 'legal_entity_onboarding' | 'account_collection' | 'payment', required
  - `options` object, required: The parameters for the selected template's flow. For `legal_entity_onboarding`, `type` (only `individual`). For `account_collection` and `payment`, the same parameters as [Create Account Collection Flow](ref:create-account-collection-flow) and [Create Payment Flow](ref:create-payment-flow).

## Response `201`

201

- object
  - `id` string
  - `object` string
  - `live_mode` boolean
  - `template` 'legal_entity_onboarding' | 'account_collection' | 'payment'
  - `client_token` string
  - `status` 'pending' | 'completed' | 'expired' | 'cancelled'
  - `expires_at` string, date-time: 7 days after the last activity on the flow.
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `options` object: The `options` from the request, plus any IDs created by Modern Treasury, such as `legal_entity_id`.

## Other responses

- `422`: 422

## Changes

- **2026-11-03** `e31c6638c72e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/modern-treasury/apis/modern-treasury-api/changes/embeddable_flows/post.md)

---

[API](https://skmtc.dev/modern-treasury/apis/modern-treasury-api.md) - [All operations](https://skmtc.dev/modern-treasury/apis/modern-treasury-api/llms.txt) - [OpenAPI document](https://skmtc.dev/modern-treasury/apis/modern-treasury-api/revisions/e31c6638c72e?raw)