Skip to main content
Create Beneficiary
curl --request POST \
  --url https://api.yapily.com/users/{userId}/beneficiaries \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "John Doe",
  "accountIdentifier": {
    "type": "IBAN",
    "identification": "DE12345123451234512345123"
  }
}
'
{
  "meta": {
    "tracingId": "<string>"
  },
  "data": {
    "beneficiaryId": "e7b7636d-a041-4013-8a1b-34dc85b7d341",
    "status": "PENDING",
    "details": {
      "name": "John Doe",
      "accountIdentifier": {
        "type": "IBAN",
        "identification": "DE12345123451234512345123"
      },
      "match": {
        "status": "FULL_MATCH",
        "closeMatchName": "John Doe"
      }
    }
  }
}

Authorizations

Authorization
string
header
required

Use HTTP Basic Authentication with your Application ID as username and Application Secret as password. Manage credentials in the Yapily Console. See Authentication for details.

Headers

sub-application
string<uuid>

The sub-application ID to which event type is being subscribed to

Path Parameters

userId
string<uuid>
required
Example:

"e7b7636d-a041-4013-8a1b-34dc85b7d341"

Body

application/json

The beneficiary to be created.

User Beneficiary details.

name
string
required

name of the beneficiary

Example:

"John Doe"

accountIdentifier
object
required

Account's details.

Response

OK

The user beneficiary response.

meta
object
data
object

Beneficiary data response.