Skip to main content
POST
/
v2
/
api
/
core
/
wallets
Create new wallet
curl --request POST \
  --url https://api.custody.api-zodia.io/v2/api/core/wallets \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Demo wallet",
  "currency": "<string>",
  "submitterEmail": "api-maker@zodia.io",
  "walletId": "ZTEST-NOBENF-849P8XKKAO",
  "beneficiaryId": "BNF-ZTEST-0DFUSJPF7A"
}
'
{
  "id": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.zodia-custody.com/llms.txt

Use this file to discover all available pages before exploring further.

Body

application/json
​
name
string
required

Display name of the wallet

Required string length: 1 - 128
Pattern: ^[a-zA-Z0-9 -]+$
Example:

"Demo wallet"

​
currency
string
required

Currency of the wallet

​
submitterEmail
string
required

Mail of the user creating the wallet

Example:

"api-maker@zodia.io"

​
walletId
string
required

ID of the wallet

Required string length: 1 - 40
Pattern: <companyId>-[NOBENF|<beneficiaryId>]-API-*
Example:

"ZTEST-NOBENF-849P8XKKAO"

​
beneficiaryId
string

ID of the beneficiary of the wallet

Required string length: 14 - 32
Example:

"BNF-ZTEST-0DFUSJPF7A"

Response

OK

​
id
string
required

Id of the entity