Create an account

Use this when an identity needs a place to hold funds, receive deposits, or fund debit cards.

A managed account is created for the logged-in consumer or corporate identity in a single currency fixed at creation. It can hold a balance, act as the parent account for debit cards, and (once it has an IBAN) send and receive wire transfers.

Prerequisites

The identity must have completed due diligence before it can create accounts; otherwise the request fails with OWNER_IDENTITY_NOT_VERIFIED. The Managed Account Profile referenced by profileId must be active and must support the requested currency.

This operation requires a stepped-up access token. Step up before calling it by issuing a challenge through Step-up.

Fields

profileId selects the Managed Account Profile configured in the Multi Portal, which determines the behavior, limits, and restrictions applied to the account. currency fixes the account's currency and can't be changed afterwards; it must be enabled on the profile, or the request fails with CURRENCY_NOT_SUPPORTED_BY_PROFILE. friendlyName is a label for your own use.

Set lowBalanceThreshold to receive a low balance notification webhook whenever the available balance drops below that amount. It is expressed in the account's own currency.

Next steps

A new account has no IBAN and starts with a zero balance. Wire transfers in either direction need bank details, so if the account is to send or receive them, call Add an IBAN to an account next.