Skip to main content
POST
/
api
/
v2.1
/
fintrans
/
{accountId}
/
beneficiaries
Create beneficiary
curl --request POST \
  --url https://sandbox.finhub.cloud/api/v2.1/fintrans/{accountId}/beneficiaries \
  --header 'Content-Type: application/json' \
  --data '
{
  "partyType": "<string>",
  "companyName": "<string>",
  "shortName": "<string>",
  "iban": "<string>",
  "currency": "<string>",
  "country": "<string>",
  "email": "<string>",
  "phoneNumber": "<string>",
  "bicSwiftCode": "<string>",
  "networkName": "<string>",
  "bankName": "<string>",
  "purposeCode": "<string>",
  "accountNumber": "<string>",
  "bankCode": "<string>",
  "addressLine1": "<string>",
  "addressLine2": "<string>",
  "city": "<string>",
  "stateProvince": "<string>",
  "postalCode": "<string>",
  "organizationId": "<string>",
  "customerId": "<string>",
  "firstName": "<string>",
  "lastName": "<string>",
  "name": "<string>",
  "targetCustomerId": "<string>",
  "type": "<string>",
  "bankAddress": "<string>",
  "bic": "<string>",
  "allowedOperations": [
    "<string>"
  ]
}
'

​
Sample cURL

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 '{
    "type": "SEPA",
    "shortName": "Partner GmbH",
    "name": "Partner GmbH",
    "iban": "DE89370400440532013000",
    "bicSwiftCode": "DEUTDEFF",
    "networkName": "SEPA",
    "bankName": "Deutsche Bank AG",
    "bankAddress": "Taunusanlage 12, 60325 Frankfurt am Main, Germany",
    "email": "finance@partner.de",
    "phoneNumber": "+49123456789",
    "purposeCode": "CBFF"
  }'

Headers

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

Path Parameters

​
accountId
string
required

Body

application/json
​
partyType
string
​
companyName
string
​
shortName
string
​
iban
string
​
currency
string
​
country
string
​
email
string
​
phoneNumber
string
​
bicSwiftCode
string
​
networkName
string
​
bankName
string
​
purposeCode
string
​
accountNumber
string
​
bankCode
string
​
addressLine1
string
​
addressLine2
string
​
city
string
​
stateProvince
string
​
postalCode
string
​
organizationId
string
​
customerId
string
​
firstName
string
​
lastName
string
​
name
string
​
targetCustomerId
string
​
type
string
​
bankAddress
string
​
bic
string
​
allowedOperations
string[]

Response

200

OK