> ## Documentation Index
> Fetch the complete documentation index at: https://cashfreepayments-d00050e9-theme-update.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Add Beneficiary
> Use this API to add a beneficiary to your Cashfree account by providing the bank account number, IFSC, and other required details. Before you request a transfer, ensure the account has been successfully added as a beneficiary.
This API will be retired soon. Please plan to migrate to the latest version, [Beneficiary V2](/api-reference/payouts/v2/beneficiary-v2/get-beneficiary-v2).
Please use this Authorization token in headers to call any payout API (Refresh this page if the token is expired)
| Sub Code | Status | Message | Next Action |
| :------- | :------ | :------------------------------------------------------------------------------------------------------------------------------------ | :-------------------------------------------------------------------------------------- |
| 200 | SUCCESS | Beneficiary added successfully | - |
| 400 | ERROR | Please provide a valid VPA | Enter a valid VPA in the API request. |
| 403 | ERROR | Token is not valid | Enter a valid token in the request. |
| 403 | ERROR | IP not whitelisted | Whitelist the API. |
| 403 | ERROR | APIs not enabled. Fill out the details in the [Support Form](https://merchant.cashfree.com/merchants/landing?env=prod\&raise_issue=1) | [Support Form](https://merchant.cashfree.com/merchants/landing?env=prod\&raise_issue=1) |
| 409 | ERROR | Beneficiary Id already exists | Enter a unique ID for the beneficiary. |
| 409 | ERROR | Entered bank Account is already registered | Enter different bank account information. |
| 412 | ERROR | Token missing in the request | Enter a valid token in the request. |
| 412 | ERROR | Beneficiary group is not an active group | |
| 412 | ERROR | Bank account and VPA are both provided in the request. Please add either of them to add the beneficiary. | Enter any of the information in the request. |
| 412 | ERROR | Cannot add yourself as a beneficiary | Enter an individual's information apart from yours to add a beneficiary. |
| 422 | ERROR | Please provide a valid Beneficiary Id | Enter a valid beneficiary ID. |
| 422 | ERROR | Please provide a valid email | Enter a valid email address. |
| 422 | ERROR | Please provide a valid name | Enter a valid name. |
| 422 | ERROR | Please provide a valid Phone Number | Enter a valid phone number. |
| 422 | ERROR | Please provide a valid Bank Account | Enter valid bank account information. |
| 422 | ERROR | Please provide a valid Bank IFSC code | Enter a valid IFSC. |
| 422 | ERROR | Please provide a valid Virtual Payee Address | Enter a valid VPA. |
| 422 | ERROR | Please provide a valid Address | Enter a valid address. |
| 422 | ERROR | Please provide a valid City Name | Enter a valid city name. |
| 422 | ERROR | Please provide a valid State Name | Enter a valid state name. |
| 422 | ERROR | Please provide a valid Pin code | Enter a valid PIN code. |
| 422 | ERROR | Cashfree VBA/VPA cannot be added as a beneficiary | Enter a different VBA/VPA to add the beneficiary. |
| 422 | ERROR | Please provide a valid MasterCard or Visa card number | Enter a valid MasterCard or Visa card number. |
| 422 | ERROR | Please provide a masked card number of a valid MasterCard or Visa card | Enter a masked card number of a valid MasterCard or Visa card. |
| 422 | ERROR | Invalid details provided | Enter valid details of the beneficiary to add the beneficiary in the system. |
| 520 | ERROR | Adding beneficiary Failed | Re-enter the details or try again after some time. |
**Note**: If you are attempting to create a transfer in the Sandbox environment, you can obtain the test data details from this [link](doc:data-to-test).