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",
    "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
​
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"