> For the complete documentation index, see [llms.txt](https://docs.switchappgo.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.switchappgo.com/transfers/beneficiaries/create-a-beneficiary.md).

# Create a beneficiary

Create a beneficiary using the recipient's bank details. 

You can also specify other details including an alias for the beneficiary (i.e. an easy-to-remember name different from the account name.)

{% openapi src="/files/ghASCTb3sGyuReVEv9vl" path="/v1/beneficiaries/create/bank-transfer" method="post" %}
[merchant-api-swagger-13-11-2024.json](https://163660187-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8qcR8TOKMHOvHEJFAJcO%2Fuploads%2FmPFg9nzRFOV2G6UwFpNo%2Fmerchant-api-swagger-13-11-2024.json?alt=media\&token=6c8d06eb-ee0e-4930-992c-24e1e40e041e)
{% endopenapi %}

{% openapi src="/files/ghASCTb3sGyuReVEv9vl" path="/v1/beneficiaries/create/gateway-transfer" method="post" %}
[merchant-api-swagger-13-11-2024.json](https://163660187-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8qcR8TOKMHOvHEJFAJcO%2Fuploads%2FmPFg9nzRFOV2G6UwFpNo%2Fmerchant-api-swagger-13-11-2024.json?alt=media\&token=6c8d06eb-ee0e-4930-992c-24e1e40e041e)
{% endopenapi %}