> ## 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.

# Create Beneficiary V2

> Use this API to add a beneficiary to your Cashfree Payments account by providing the bank account number, IFSC, and other required details. Ensure the successful creation of the benficiary in your account before initiating a transfer.

<Note>
  Note: Cashfree no longer support adding beneficiaries with Paytm UPI handles.
</Note>

<Accordion title="Click to view the response codes.">
  | HTTP Status Code | Error Code                              | Message                                                                                                                 | Next Action                                                                                               |
  | :--------------- | :-------------------------------------- | :---------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------- |
  | 201              | -                                       | -                                                                                                                       | -                                                                                                         |
  | 400              | beneficiary\_id\_length\_exceeded       | beneficiary\_id : should not be more than 50 characters long. value received: test\_bene\_id                            | Enter a valid beneficiary\_id.                                                                            |
  | 400              | beneficiary\_id\_invalid                | beneficiary\_id : should contain only letters, numbers, hyphen, underscore, pipe, and dot. Value received: .\qewqefwqev | Enter a valid beneficiary\_id.                                                                            |
  | 400              | bank\_ifsc\_missing                     | bank\_ifsc : should be provided with the request if bank\_account\_number is provided                                   | Provide a valid bank\_ifsc if bank\_account\_number is provided.                                          |
  | 400              | bank\_account\_number\_missing          | bank\_account\_number: should be provided with the request if bank\_ifsc is provided                                    | Provide a valid bank\_account\_number is bank\_ifsc is provided.                                          |
  | 400              | bank\_account\_number\_length\_exceeded | bank\_account\_number : should not be more than 25 characters long. value received: 235142352346523462456345263452345   | Provide a valid bank\_account\_number.                                                                    |
  | 400              | bank\_account\_number\_length\_short    | bank\_account\_number : should not be less than 4 characters long. value received: 12                                   | Provide a valid bank\_account\_number.                                                                    |
  | 400              | bank\_account\_number\_invalid          | bank\_account\_number : should be alphanumeric. value received: 123@                                                    | Provide a valid bank\_account\_number.                                                                    |
  | 400              | bank\_ifsc\_invalid                     | bank\_ifsc : please provide a valid IFSC. value received: SBIN00708410                                                  | Provide a valid bank\_ifsc.                                                                               |
  | 400              | beneficiary\_purpose\_invalid           | beneficiary\_purpose : invalid value provided. Value received: paytm                                                    | Provide a valid beneficiary\_purpose.                                                                     |
  | 409              | beneficiary\_id\_already\_exists        | Beneficiary already exists with the given beneficiary\_id                                                               | Provide a beneficiary\_id that is not in use                                                              |
  | 409              | beneficiary\_already\_exists            | Beneficiary already exists with the given bank\_account\_number and bank\_ifsc                                          | Use the GET API to get the details of the existing beneficiary using bank\_account\_number and bank\_ifsc |
  | 422              | bank\_account\_number\_same\_as\_source | bank\_account\_number provided is the same as source bank account                                                       | Enter a bank\_account\_number that is different from the source bank account                              |
  | 422              | vba\_beneficiary\_not\_allowed          | Virtual bank account as bank\_account\_number for the beneficiary is not allowed                                        | Enter the actual bank\_account\_number instead of the virtual account number                              |
</Accordion>