Skip to main content
POST
Associate an embedded wallet with a customer

Authorizations

Authorization
string
header
required

Token from POST /auth/token

Headers

Idempotency-Key
string
required

Unique key to prevent duplicate requests. Required on all POST requests.

Path Parameters

customerId
string
required

Body

application/json
idToken
string
required

WaaS-issued idToken (ES256 JWT). Its subject is the wallet id and its audience must be the authenticated project.

Example:

"eyJhbGciOiJFUzI1NiIs..."

Response

Wallet associated

Embedded wallet linked to a customer.

id
string
Example:

"wlt_01H9Xa8F5dN6mP3q"

object
string
Example:

"wallet"

customer
string | null
Example:

"cst_01H9Xa8F5dN6mP3q"

custodyType
enum<string>
Available options:
custodial,
embedded
Example:

"embedded"

blockchainAddress
string | null
Example:

"0x1234567890abcdef1234567890abcdef12345678"

networkFamily
string | null
Example:

"evm"

status
enum<string> | null
Available options:
preallocated,
active,
suspended
Example:

"active"

createdAt
string<date-time> | null
updatedAt
string<date-time> | null