Skip to main content
POST
/
api
/
v2.1
/
fintrans
/
beneficiaries
Create beneficiary (no accountId)
curl --request POST \
  --url https://sandbox.finhub.cloud/api/v2.1/fintrans/beneficiaries \
  --header 'Content-Type: application/json' \
  --data '
{
  "customerId": "<string>",
  "tenantId": "<string>",
  "beneficiaryId": "<string>",
  "beneficiary": {
    "id": "<string>",
    "partyType": "<string>",
    "userName": "<string>",
    "shortName": "<string>",
    "email": "<string>",
    "phoneNumber": "<string>",
    "companyName": "<string>",
    "status": "<string>",
    "organizationId": "<string>",
    "customerId": "<string>",
    "tenantId": "<string>",
    "firstName": "<string>",
    "lastName": "<string>",
    "iban": "<string>",
    "bicSwiftCode": "<string>",
    "country": "<string>",
    "currency": "<string>",
    "pepCheckResult": "<string>",
    "nextKycPepCheckDate": "<string>",
    "saveBeneficiaryForFutureTransfer": true,
    "documents": [
      "<unknown>"
    ],
    "bankName": "<string>",
    "bankAddress": "<string>",
    "networkName": "<string>",
    "purposeCode": "<string>"
  }
}
'

​
Sample cURL

curl --request POST \
  --url 'https://sandbox.finhub.cloud/api/v2.1/fintrans/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 '{
    "beneficiary": {
      "type": "SEPA",
      "name": "Partner GmbH",
      "iban": "DE89370400440532013000",
      "bicSwiftCode": "DEUTDEFF"
    }
  }'

Headers

​
X-Tenant-ID
string
​
X-User-ID
string

Body

application/json
​
customerId
string
​
tenantId
string
​
beneficiaryId
string
​
beneficiary
object

Response

200

OK