post
https://api.lirium-sandbox.com/v1/customers//address_book
Add a new address to a customer's address book.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Creates a new entry in a customer's address book. Address book entries allow customers to save frequently used cryptocurrency addresses for quick access when creating send orders.
Request
POST /customers/{customer_id}/address_book
Request Body
| Field | Type | Required | Description | Example |
|---|---|---|---|---|
| address | string | Yes | The cryptocurrency address to save | "bc1qmv4pr0hs4gd3s7chgacccr3m9ajf7xdcf7mfrm" |
| network | string | Yes | The blockchain network for the address | "bitcoin" |
| label | string | No | A friendly label for the address | "My BTC wallet" |
| ownership_type | string | No | Relationship between the customer and the address owner. Possible values: self, third_party | "third_party" |
| beneficiary_full_name | string | No | Full name of the beneficiary. Used when ownership_type is third_party | "John Doe" |
Response Fields
| Field | Type | Description | Example |
|---|---|---|---|
| id | string | Unique identifier for the address book entry | "ewteqwtqewtqwetqwetqwetq" |
| address | string | The saved cryptocurrency address | "bc1qmv4pr0hs4gd3s7chgacccr3m9ajf7xdcf7mfrm" |
| network | string | The blockchain network | "bitcoin" |
| label | string | null | The friendly label | "My BTC wallet" |
| created | string | ISO 8601 creation timestamp | "2021-01-25T20:38:31+00:00" |
| last_used | string | null | ISO 8601 timestamp of last use | null |
| ownership_type | string | null | Ownership relationship: self or third_party | "third_party" |
| beneficiary_full_name | string | null | Full name of the beneficiary | "John Doe" |
Error Responses
| Status | Error Code | Description |
|---|---|---|
| 400 | invalid_parameters | Request validation failed |
| 404 | not_found | Customer not found |