Skip to main content
DELETE
https://apis.hopnow.io
/
v1
/
accounts
/
{account_id}
/
beneficiaries
/
{beneficiary_id}
Delete Beneficiary
curl --request DELETE \
  --url https://apis.hopnow.io/v1/accounts/{account_id}/beneficiaries/{beneficiary_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "object": "<string>",
  "deleted": true
}

Path Parameters

account_id
string
required
The account’s external ID (starts with acc_)
beneficiary_id
string
required
The beneficiary’s external ID (starts with ben_)

Response

id
string
The beneficiary identifier that was deactivated
object
string
Always returns "beneficiary"
deleted
boolean
Always returns true

Response Example

{
  "id": "ben_1234567890abcdef",
  "object": "beneficiary",
  "deleted": true
}