Skip to main content
PUT
/
v2
/
international
/
beneficiaries
/
{id}
Update an international beneficiary
curl --request PUT \
  --url https://thirdparty.qonto.com/v2/international/beneficiaries/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "quote_id": "0196edb0-9b6e-7554-9864-d111285a0a44",
  "payload": {
    "currency": "EUR",
    "type": "aba",
    "details": {
      "address": {
        "city": "Paris",
        "country": "FR",
        "postCode": 75009,
        "firstLine": "18 rue du Navarin"
      },
      "swiftCode": "AAABBB00",
      "accountNumber": 123456789,
      "accountHolderName": "John Doe"
    }
  }
}
'
{ "beneficiary": { "id": "0d6273cf-e4d0-469a-a3c8-d2196143470c", "name": "John Doe", "country": "US", "currency": "USD", "payment_type": "aba", "account_identifier": "123456789", "legal_type": "LEGAL_TYPE_COMPANY", "owned_by_customer": false, "bank_identifier": "AAABBB00", "branch_identifier": "123456789" }, "quote": { "id": "123e4567-e89b-12d3-a456-426614174000", "status": "PENDING", "created_at": "2025-01-01T08:00:00.000Z", "expired_at": "2025-01-01T08:00:00.000Z", "source_amount": { "currency": "EUR", "value": "100.00" }, "target_amount": { "currency": "USD", "value": "110.00" }, "rate": 1.1, "fees": { "total_amount": { "currency": "EUR", "value": "10.10" }, "details": [ { "currency": "EUR", "value": "10.10" } ] } }, "target_account_id": "123456" }
The payload object for this endpoint is the same as the one used in the List Beneficiary requirements endpoint.

Authorizations

​
Authorization
string
header
required

Bearer authorization header: Bearer <token>, where <token> is the access token received from the authorization server at the end of the OAuth 2.0 flow.

Headers

​
X-Qonto-Staging-Token
string

Required only for Sandbox API requests; to get one, please sign up to the Developer Portal.

Path Parameters

​
id
string<uuid>
required

Body

application/json

Payload to update an existing international beneficiary. legal_type and owned_by_customer are set at creation time and cannot be changed via update — they are intentionally not part of this payload.

​
quote_id
string<uuid>
required

The quote unique identifier

Example:

"0196edb0-9b6e-7554-9864-d111285a0a44"

​
payload
object
required

Response

Returns the international beneficiary update

​
beneficiary
object
​
quote
object
​
target_account_id
string

The ID of the beneficiary's target account

Example:

"123456"