curl --request PATCH \
--url https://api.next.orenda.finance/customer/{customerId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"tier": "premium"
}
'{
"success": true,
"customerId": "c1a2b3c4-5d6e-7f80-91a2-b3c4d5e6f708",
"tier": "premium",
"phone": "+447700900123",
"email": "jordan.taylor@example.com",
"updatedAt": "2026-06-29T19:14:08.000Z"
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "The request could not be processed. Check the request parameters and body and try again."
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "The request could not be processed. Check the request parameters and body and try again."
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "The request could not be processed. Check the request parameters and body and try again."
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "The request could not be processed. Check the request parameters and body and try again."
}
}Update a customer
Updates editable fields on a customer record from the back office. Only the fields you send are changed; omitted fields are left untouched. Use this to correct a customer’s contact details or to move them to a different tier.
Note: the path is singular (/customer/...), unlike most customer endpoints.
Legacy path. This operation has no /v1 equivalent yet, so the unprefixed path is still the only one. It will move to /v1 in a later release.
curl --request PATCH \
--url https://api.next.orenda.finance/customer/{customerId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"tier": "premium"
}
'{
"success": true,
"customerId": "c1a2b3c4-5d6e-7f80-91a2-b3c4d5e6f708",
"tier": "premium",
"phone": "+447700900123",
"email": "jordan.taylor@example.com",
"updatedAt": "2026-06-29T19:14:08.000Z"
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "The request could not be processed. Check the request parameters and body and try again."
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "The request could not be processed. Check the request parameters and body and try again."
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "The request could not be processed. Check the request parameters and body and try again."
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "The request could not be processed. Check the request parameters and body and try again."
}
}Authorizations
The back-office user's id_token — the ID token, not the access_token. The API rejects access tokens.
Path Parameters
The customer's ID.
Query Parameters
The program the customer/account belongs to. Required on every request.
Body
Response
The customer record was updated.
Standard mutation envelope. Additional fields may be present depending on the operation.
true