> For the complete documentation index, see [llms.txt](https://requestmechanic.gitbook.io/request-mechanic-api-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://requestmechanic.gitbook.io/request-mechanic-api-documentation/wallets/create-transfer-recipient.md).

# Create Transfer Recipient

The `POST /wallets/banks/transfer-recipient/` endpoint is used to create a transfer recipient for withdrawals.

***

#### Parameters

**Request Body**

| **Field**        | **Type** | **Required** | **Description**                   | **Constraints**                |
| ---------------- | -------- | ------------ | --------------------------------- | ------------------------------ |
| `account_name`   | String   | Yes          | Name associated with the account. | Min length: 1, Max length: 255 |
| `account_number` | String   | Yes          | Account number of the recipient.  | Min length: 1, Max length: 255 |
| `bank_code`      | String   | Yes          | Code of the recipient's bank.     | Min length: 1, Max length: 255 |

***

#### Example Request Body

```json
{
  "account_name": "John Doe",
  "account_number": "1234567890",
  "bank_code": "001"
}
```

***

#### Responses

**201 Created**

| **Field**        | **Type** | **Description**                   |
| ---------------- | -------- | --------------------------------- |
| `account_name`   | String   | Name associated with the account. |
| `account_number` | String   | Account number of the recipient.  |
| `bank_code`      | String   | Code of the recipient's bank.     |

***

#### Example Response

```json
{
  "account_name": "John Doe",
  "account_number": "1234567890",
  "bank_code": "001"
}
```