Skip to main content
Create an Account
curl --request POST \
  --url http://127.0.0.1:3000/v1/organizations/{organization_id}/ledgers/{ledger_id}/accounts \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "assetCode": "BRL",
  "name": "Primary BRL Wallet",
  "alias": "@customer_brl_wallet",
  "type": "CHECKING",
  "status": {
    "code": "ACTIVE",
    "description": "Operational retail account for Pix and internal payments"
  },
  "metadata": {
    "bankCode": "341",
    "branchNumber": "0001",
    "accountNumber": "12345678-9",
    "accountPlan": "retail_personal_wallet",
    "dailyLimit": 50000
  }
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "organizationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "ledgerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "assetCode": "<string>",
  "name": "<string>",
  "alias": "<string>",
  "type": "deposit",
  "parentAccountId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "entityId": "<string>",
  "portfolioId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "segmentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": {
    "status": {
      "description": "<string>",
      "code": "<string>"
    }
  },
  "metadata": {},
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "deletedAt": "2023-11-07T05:31:56Z"
}

Headers

​
Authorization
string

The authorization token. This header is required if your environment has the Access Manager enabled.

​
Content-Type
string
required

The type of media of the resource. Must be application/json.

​
X-Request-Id
string

A unique identifier used to trace and track each request.

Path Parameters

​
organization_id
string
required

The unique identifier of the Organization associated with the Ledger.

​
ledger_id
string
required

The unique identifier of the associated Ledger.

Body

application/json
​
assetCode
string
required

The code that identifies the Asset used in the Account. Important: Must be an Asset that you've already created using the Create an Asset endpoint.

​
alias
string
required

A unique, user-friendly identifier for the account. Used to reference the account in transactions and other operations. If not provided, the system will use the account's ID as the alias.

Maximum string length: 100
​
type
enum<string>
required

The type of account.

Available options:
deposit,
savings,
loans,
marketplace,
cerditCard,
external
​
name
string

The name of the Account.

Maximum string length: 256
​
parentAccountId
string<uuid> | null

The unique identifier of the Parent Account. If the account does not have a parent account, this field will be null.

​
entityId
string | null

The unique identifier of the Entity responsible for the Account.

​
portfolioId
string<uuid> | null

The unique identifier of the associated Portfolio.

​
segmentId
string<uuid> | null

The unique identifier of the Segment which is used to cluster the Account.

​
status
object

An object containing information about the status. Important: If not provided, the default status will be 'ACTIVE'.

​
metadata
object

An object containing key-value pairs to add as metadata, where the field name is the key and the field value is the value. For example, to add a Cost Center, use 'costCenter': 'BR_11101997'.

Response

Indicates that the request was successful and the response contains the expected data.

​
id
string<uuid>

The unique identifier of the Account.

​
organizationId
string<uuid>

The unique identifier of the Organization.

​
ledgerId
string<uuid>

The unique identifier of the Ledger.

​
assetCode
string

The code that identifies the Asset used in the Account.

​
name
string

The name of the Account.

Maximum string length: 256
​
alias
string

A unique, user-friendly identifier for the account. Used to reference the account in transactions and other operations.

​
type
enum<string>

The type of account.

Available options:
deposit,
savings,
loans,
marketplace,
cerditCard,
external
​
parentAccountId
string<uuid> | null

The unique identifier of the Parent Account.

​
entityId
string | null

The unique identifier of the Entity responsible for the Account.

​
portfolioId
string<uuid> | null

The unique identifier of the associated Portfolio.

​
segmentId
string<uuid> | null

The unique identifier of the Segment which is used to cluster the Account.

​
status
object

An object containing information about the status.

​
metadata
object

An object containing key-value pairs to add as metadata, where the field name is the key and the field value is the value. For example, to add a Cost Center, use 'costCenter': 'BR_11101997'.

​
createdAt
string<date-time>

Timestamp of creation (UTC).

​
updatedAt
string<date-time>

Timestamp of last update (UTC).

​
deletedAt
string<date-time> | null

Timestamp of soft deletion, if applicable (UTC).