URL: /baas/api/reference/financial-operations/beneficiaries/create

---
title: 'Create beneficiary'
---

## Sample cURL

```bash
curl --request POST \
  --url 'https://sandbox.finhub.cloud/api/v2.1/fintrans/{accountId}/beneficiaries' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --header 'X-Tenant-Id: <TENANT_ID>' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'User-Agent: <USER_AGENT>' \
  --header 'X-Forwarded-From: <FORWARDED_FROM>' \
  --header 'platform: Web' \
  --header 'deviceId: <DEVICE_ID>' \
  --data '{
    "name": "Acme Corporation",
    "shortName": "Acme Corp",
    "iban": "DE89370400440532013000",
    "bicSwiftCode": "DEUTDEFF",
    "currency": "EUR",
    "country": "DE",
    "networkName": "SEPA",
    "bankName": "Deutsche Bank AG",
    "bankAddress": "Taunusanlage 12, 60325 Frankfurt am Main, Germany",
    "purposeCode": "SUPP",
    "email": "finance@acme.com",
    "phoneNumber": "+4912345678"
  }'
```

## Response Example

```json
{
  "code": 200,
  "data": {
    "id": "df019bb3-ad7f-440c-ba01-b79e27ef8a3f",
    "name": "Acme Corporation",
    "shortName": "Acme Corp",
    "iban": "DE89370400440532013000",
    "status": "ACTIVE",
    "currency": "EUR",
    "country": "DE",
    "networkName": "SEPA",
    "bankName": "Deutsche Bank AG",
    "email": "finance@acme.com",
    "phoneNumber": "+4912345678",
    "purposeCode": "SUPP"
  },
  "message": "Success"
}
```

<Note>
  The returned `id` is the beneficiaryId used in subsequent transfer operations (prepare/execute).
</Note>