Skip to main content
POST
Create a treasury account

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
currency
string
required

ISO 4217 currency code

Example:

"USD"

name
string
required

Display name for the treasury account

Required string length: 1 - 100
description
string | null

Optional description of the treasury account

Maximum string length: 255
treasury_pool_id
string

Public ID of the treasury pool to use. Required when the organization has more than one active treasury pool; omit when only one pool exists (that pool is used automatically).

Example:

"tp_abc123"

Response

Treasury account created.

id
string
Example:

"tac_b0TrsSg91h"

name
string

Display name for the treasury account

Example:

"Collected Premium"

description
string | null

Optional description of the treasury account

Example:

"Treasury account for premium collections"

currency
string

ISO 4217 currency code

Example:

"USD"

account_holder_id
string | null

ID of the entity that holds/owns this treasury account

Example:

"pyee_abc123"

balance
integer

Amount in smallest currency unit

Example:

125000

created_at
string<date-time>
Example:

"2025-10-08T18:20:31Z"

updated_at
string<date-time>
Example:

"2025-10-08T18:25:00Z"

Last modified on July 8, 2026