Create a custody account group
Creates a new custody account group for the calling entity.
If accountIds is provided, those accounts are assigned to the new
group in the same transaction. Accounts must belong to the caller’s
entity; accounts already assigned to a different group are reassigned.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
Universally unique identifier (UUID v4) idempotency key. This key is utilized to ensure exactly-once execution of mutating requests.
"ba943ff1-ca16-49b2-ba55-1057e70ca5c7"
Display name.
32"Team A"
Optional list of accounts to assign to the new group at creation time. Each account must belong to the caller's entity. Accounts already assigned to another group are reassigned. Max 100 entries.
100Response
Successfully created the custody account group.
A customer-defined grouping of custody accounts owned by a single entity. Each account can belong to at most one group at a time.
The approximateBalanceInUsd and accountsPreview fields are aggregate views populated by the list-groups endpoint. The single-group detail endpoint returns the metadata-only view and omits both fields.