crate::account::agreement::controller::openapi_v2::signatures1

crate::account::identity::controller::openapi::business::accounts9

crate::account::identity::controller::openapi::individual::accounts1

crate::connectivity::controller::openapi::deposit_instructions5

crate::connectivity::controller::openapi::withdrawals3

crate::connectivity::fiat::controller::openapi::external_accounts5

crate::connectivity::fiat::controller::openapi::fiat_deposit_accounts1

crate::connectivity::fiat::controller::openapi::virtual_accounts7

crate::trading::controller::openapi::conversions3

crate::transaction::compliance::rfi::controller::openapi4

crate::transaction::compliance::rfi::controller::preflight1

crate::transaction::history::controller::openapi::transactions2

crate::transaction::instruction::controller::openapi::auto_conversion_rule7

crate::transaction::ledger::controller::openapi::assets1

crate::transaction::ledger::controller::openapi::transfers3

crate::transaction::pricing::controller::openapi::fees1

crate::transaction::pricing::controller::openapi::partner_fee_routes5

crate::web::openapi::recipients12

crate::web::openapi::simulations1

Webhook recovery6

crate::account::identity::controller::openapi::business::accounts

POST /v2/accounts/{main_account_id}/businesses/onboarding-sessions

Changed on Nov 3, 2026

Request

Base URL
https://api.1money.com
Auth
HTTP bearer

Path parameters

main_account_idstring required

Parent account id — the MAIN or an approved business sub-account under your account, in the form BZ-XXXX-XXXX.

Headers

Idempotency-Keystring required

Idempotency key identifying the hosted business onboarding draft

Request body

legal_namestring required

Legal name of the business being onboarded. 1–100 characters. Only letters, numbers, spaces, and the characters / - ? : ( ) . , ' + are allowed.

redirect_urlstring nullable

Optional URL where the customer is redirected after completing — or abandoning — the hosted onboarding journey. Must be a valid absolute URL when provided.

Example request

{
  "legal_name": "Acme Corporation",
  "redirect_url": "https://client.example/onboarding/return"
}

Response

Hosted onboarding session link created successfully.

account_idstring

onboarding_urlstring required

1Money-hosted URL that walks the customer through the full business onboarding journey. Share this URL with the customer.

expires_atstring required

Timestamp at which the hosted onboarding URL expires (RFC 3339 format).

Example response

{
  "onboarding_url": "https://app.1money.com/api/hosted/public/onboarding/exchange?grant_token=550e8400-e29b-41d4-a716-446655440000",
  "expires_at": "2026-05-04T12:30:00Z"
}

Changes

Nov 3, 2026d213edbaccb6 Revision changes
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- info
  api tag crate::account::identity::controller::openapi::business::accounts added
- info
  api tag Onboarding V2 removed
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status

Operation history