Update beneficiary

put

https://api.sandbox.toq.io/wallet/api/customers/{customerId}/clients/{clientId}/beneficiaries/{beneficiaryId}

Updates the details of an existing beneficiary. The request body has the same shape as Create Beneficiary; fields provided overwrite the previous values. Bank account information should only be edited when the beneficiary is not yet referenced by an in-flight payment.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

beneficiaryId

string

required

beneficiaryId

clientId

string

required

clientId

customerId

string

required

customerId

Body Params

Beneficiary fields to update

companyId

string

The id of the client

type

string

enum

Allowed:

addressCity

string

length ≤ 100

addressIsoCountry

string

required

length ≤ 100

addressPostalCode

string

length ≤ 100

addressStreet

string

length ≤ 1000

assetType

string

enum

The asset of the beneficiary

bank

string

Name of the beneficiary bank

bankCountry

string

required

Country of the beneficiary bank

bicSwift

string

accountNumber

string

For US, Australian and Canadian accounts

bsbCode

string

Just for Australian accounts

caRoutingNumber

string

Just for Canadian accounts

iban

string

routingNumber

string

Just for US accounts

ukAccountNumber

string

Just for UK accounts

ukSortCode

string

Just for UK accounts

firstName

string

length ≤ 100

required if type is PERSON

lastName

string

length ≤ 100

required if type is PERSON

name

string

length ≤ 60

required if type is COMPANY

visible

boolean

Defaults to true

allows a user to display or not a beneficiary. True by default

Responses

201

Created

401

Unauthorized

403

Forbidden

404

Not Found

Language

Credentials

OAuth2

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

*/*

200OK