Managed accounts

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.

post/managed_accounts

Request

  • Base URL: https://sandbox.weavr.io/multi
  • URL: https://sandbox.weavr.io/multi/managed_accounts
  • Auth: HTTP bearer and API key in header api-key

Headers

idempotency-refstring
Example:transfer-2026-08-07-001

A unique call reference generated by the caller that, taking into consideration the payload as well as the operation itself, helps avoid duplicate operations. Idempotency reference uniqueness is maintained for at least 24 hours.

Request body

profileIdstring required

The profile Id which a specific identity, instrument, or transaction type is linked to.

Profiles contain configuration and determine behavioral aspects of the newly created transaction, for example, fees that may apply.

You can have one or more profiles linked to your application, and these can be used to drive different behaviors according to your product's needs.

Profile Ids can be found in the Multi Portal, in the API Credentials page.

friendlyNamestring required

The friendly name to be given to the managed account.

currencystring required

The currency expressed in ISO-4217 code. Example: GBP, EUR, USD.

tagstring

The tag field is a custom field that can be used to search and filter.

lowBalanceThresholdinteger

Sends a low balance notification webhook when the available balance drops below this amount. Currency is inherited from the managed account.

Example request

{
  "profileId": "10001",
  "currency": "GBP",
  "tag": "customer-123",
  "lowBalanceThreshold": 10000
}

Response

Success

idstring required

The unique identifier of a Managed Account.

profileIdstring required

The profile Id which a specific identity, instrument, or transaction type is linked to.

Profiles contain configuration and determine behavioral aspects of the newly created transaction, for example, fees that may apply.

You can have one or more profiles linked to your application, and these can be used to drive different behaviors according to your product's needs.

Profile Ids can be found in the Multi Portal, in the API Credentials page.

tagstring

The tag field is a custom field that can be used to search and filter.

friendlyNamestring required

The friendly name given to the managed account.

currencystring required

The currency expressed in ISO-4217 code. Example: GBP, EUR, USD.

creationTimestampinteger required

The time when the managed account was created, expressed in Epoch timestamp using millisecond precision.

lowBalanceThresholdinteger

Sends a low balance notification webhook when the available balance drops below this amount. Currency is inherited from the managed account.

Example response

{
  "id": "123456789",
  "profileId": "10001",
  "tag": "customer-123",
  "friendlyName": "Main GBP account",
  "currency": "GBP",
  "balances": {
    "availableBalance": 120000,
    "actualBalance": 125000
  },
  "creationTimestamp": 1786118400000,
  "lowBalanceThreshold": 10000
}

Changes

No recorded changes to this operation across all 1 revision of this API.