Create Embeddable Flow

Changed on

Create an embeddable flow

post/embeddable_flows

Request

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

Request body

template'legal_entity_onboarding' | 'account_collection' | 'payment' required
optionsobject 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 and Create Payment Flow.

Response

201

idstring
objectstring
live_modeboolean
template'legal_entity_onboarding' | 'account_collection' | 'payment'
client_tokenstring
status'pending' | 'completed' | 'expired' | 'cancelled'
expires_atstring date-time

7 days after the last activity on the flow.

created_atstring date-time
updated_atstring date-time
optionsobject

The options from the request, plus any IDs created by Modern Treasury, such as legal_entity_id.

Example response

{
  "id": "0199f2c1-6a4e-7c2b-9d3f-5b8e1a2c4d6f",
  "object": "embeddable_flow",
  "live_mode": true,
  "template": "legal_entity_onboarding",
  "client_token": "le-live-fmsXHyYikKHstYHeSB6Co5AjezMqKoFKFhKmwnY2tvJMUFmndkarJY7GcwYkcBvr",
  "status": "pending",
  "expires_at": "2026-11-02T18:00:00Z",
  "created_at": "2026-10-26T18:00:00Z",
  "updated_at": "2026-10-26T18:00:00Z",
  "options": {
    "type": "individual",
    "legal_entity_id": "0199f2c1-6a51-7e8a-b2c4-8d0f3a5b7c9e"
  }
}

Changes