PATCH
/
customer
/
{customerId}
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

​
Authorization
string
header
required

The back-office user's access token.

Path Parameters

​
customerId
string<uuid>
required

The customer's ID.

Query Parameters

​
programId
string
required

The program the customer/account belongs to. Required on every request.

Body

application/json

At least one field should be supplied. Only the fields present are updated.

​
tier
string

New tier for the customer.

Example:

"premium"

​
phone
string

New phone number in E.164 format.

Example:

"+447700900123"

​
email
string<email>

New email address.

Example:

"jordan.taylor@example.com"

Response

The customer record was updated.

Standard mutation envelope. Additional fields may be present depending on the operation.

​
success
boolean
Example:

true