POST
/
v1
/
wallets
/
{walletId}
/
beneficiaries
Create
curl --request POST \
  --url https://api.blockradar.co/v1/wallets/{walletId}/beneficiaries \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '"{\n    \"name\": \"Ledger Wallet\",\n    \"address\": \"0x2455eC6700092991Ce0782365A89d5Cd89c8Fa22\",\n    \"settlementFrequency\": \"DAILY\", // Optional: INSTANT, DAILY, WEEKLY, MONTHLY, YEARLY\n    \"isWhitelisted\": true  // Optional\n}"'
{
  "data": {
    "address": "0x2455eC6700092991Ce0782365A89d5Cd89c8Fa22",
    "createdAt": "2025-08-27T22:27:17.071Z",
    "deletedAt": null,
    "id": "cc7a86eb-28f8-49e0-aa77-eb01bb38ad2b",
    "isActive": true,
    "isDefault": false,
    "isSettlement": true,
    "isWhitelisted": true,
    "name": "Ledger Wallet",
    "settlementFrequency": "DAILY",
    "updatedAt": "2025-08-27T22:27:17.071Z"
  },
  "message": "Beneficiary created successfully",
  "statusCode": 200
}

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
walletId
string
required
Example:

"YOUR_WALLET_ID"

Body

application/json · any

The body is of type any.

Response

201 - application/json

200

The response is of type object.