Skip to main content
POST
/
recipients
Create Recipient
curl --request POST \
  --url https://api.caminotreasury.com/v1/recipients \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "address": "<string>",
  "label": "<string>"
}
'
{
  "id": 42,
  "address": "0x742d35cc6634c0532925a3b844bc454e4438f44e",
  "label": "Treasury Cold Wallet",
  "createdAt": "2026-05-20T12:00:00.000Z",
  "updatedAt": "2026-05-20T12:00:00.000Z"
}

Authorizations

​
x-api-key
string
header
required

API key for authentication. Pass your key in the x-api-key header.

Headers

​
Idempotency-Key
string
required

Caller-chosen string (≤256 chars) that uniquely identifies this request. Resending the same key replays the original response; reusing the same key with a different body returns 422. Keys are scoped per organization.

Required string length: 1 - 256

Body

application/json
​
address
string
required

Ethereum address (normalized to lowercase on write).

Pattern: ^0x[a-fA-F0-9]{40}$
​
label
string
required
Required string length: 1 - 100

Response

Recipient created

A saved destination address (address book entry). Org-scoped; address is unique per organization.

​
id
integer
required

Recipient id.

​
address
string
required

Lowercase 0x-address.

Pattern: ^0x[a-fA-F0-9]{40}$
​
label
string
required
Required string length: 1 - 100
​
createdAt
string<date-time>
required
​
updatedAt
string<date-time>
required