---
title: "Create"
method: POST
path: "/v1/wallets/{walletId}/beneficiaries"
tags: ["Beneficiaries"]
---

# Create

`POST /v1/wallets/{walletId}/beneficiaries`

This endpoint allows you to add a beneficiary to a specific wallet.

### Body Parameters

| Key | Required | Type | Description |
| --- | --- | --- | --- |
| name | true | string | The name of the beneficiary (e.g., "Ledger Wallet"). |
| address | true | string | The wallet address of the beneficiary. |
| settlementFrequency | false | enum | How often settlements should occur. Possible values: `INSTANT`, `DAILY`, `WEEKLY`, `MONTHLY`, `YEARLY`. |
| isWhitelisted | false | boolean | Indicates whether the beneficiary address should be whitelisted. Whitelisted addresses restrict withdrawals to only whitelisted addresses for enhanced security. |

## Response `201`

200

- object
  - `data` object
    - `address` string
    - `createdAt` string
    - `deletedAt` unknown
    - `id` string
    - `isActive` boolean
    - `isDefault` boolean
    - `isSettlement` boolean
    - `isWhitelisted` boolean
    - `name` string
    - `settlementFrequency` string
    - `updatedAt` string
  - `message` string
  - `statusCode` number

---

[API](https://skmtc.net/blockradar/apis/blockradar-documentation.md) · [All operations](https://skmtc.net/blockradar/apis/blockradar-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/blockradar/blockradar-documentation/revisions/97f95b4cfc0d/schema)