Create a private beneficiary

Requires beneficiary.manage. The destination is encrypted and returned only as a mask.

AuthorizationBearer

Scoped Lipafy API key, OAuth token, or dashboard token

This endpoint expects an object.

typestringRequired

display_namestringRequired

payment_railenumRequired

destinationstringRequired

legal_namestringOptional

account_reference_requiredbooleanOptional

bank_codestringOptional

Beneficiary created

400

Bad Request Error

409

Conflict Error

$	curl -X POST https://api.lipafy.xyz/v1/beneficiaries \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"type": "BILLER",
>	"display_name": "Sandbox Water Company",
>	"payment_rail": "MPESA_B2B",
>	"destination": "123456"
>	}'