Skip to main content
PATCH
/
v1
/
accounts
/
{account_id}
/
beneficiaries
/
{beneficiary_id}
/
payout-destinations
/
{destination_id}
Update Payout Destination
curl --request PATCH \
  --url https://api.hopnow.io/v1/accounts/{account_id}/beneficiaries/{beneficiary_id}/payout-destinations/{destination_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "is_default": true
}
'

​
Path Parameters

​
account_id
string
required
The account’s external ID (starts with acct_)
​
beneficiary_id
string
required
The beneficiary’s external ID (starts with bene_)
​
destination_id
string
required
The payout destination’s external ID (starts with dest_)

​
Request Body

​
is_default
boolean
Set as default destination for this beneficiary

​
Response

Returns the updated payout destination object with same structure as Create Payout Destination response.

​
Response Example

{
  "id": "dest_1234567890abcdef",
  "object": "payout_destination",
  "beneficiary_id": "bene_9gt1ummgx127biovlurm9mq2",
  "country": "US",
  "payout_method": "ach",
  "type": "bank_account",
  "label": null,
  "currency": "USD",
  "network": null,
  "status": "active",
  "account_number_last4": "7890",
  "routing_number": "021000021",
  "account_type": "checking",
  "is_default": true,
  "created": "2024-01-15T10:00:00Z",
  "updated": "2024-01-16T10:00:00Z"
}