Skip to main content
Update a customer record. This is a full replacement — all required fields must be provided, even if you are only changing one of them. 
PUT https://api.yativo.com/api/v1/customer/{customer_id}
Requires an Idempotency-Key header.

​
Path parameters

​
customer_id
string
required
The UUID of the customer to update.

​
Request body

​
customer_name
string
required
Full name of the customer (individual) or legal business name (business).
​
customer_email
string
required
Customer’s email address.
​
customer_phone
string
required
Customer’s phone number.
​
customer_country
string
required
Customer’s country in ISO 3166-1 alpha-3 format (e.g. USA, BRA, MEX).
​
customer_address
object
required
Customer’s address details.
​
customer_id
string
required
The customer ID. Must match an existing customer record.
curl -X PUT 'https://api.yativo.com/api/v1/customer/c586066b-0f29-468f-b775-15483871a202' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: update-customer-alex-smith-002' \
  -d '{
    "customer_id": "c586066b-0f29-468f-b775-15483871a202",
    "customer_name": "Alex Smith",
    "customer_email": "alex.smith@example.com",
    "customer_phone": "+15559876543",
    "customer_country": "USA",
    "customer_address": {
      "street": "123 Main St",
      "city": "New York",
      "state": "NY",
      "postal_code": "10001"
    }
  }'

{
  "status": "success",
  "status_code": 200,
  "message": "Customer updated successfully",
  "data": {
    "id": 1,
    "customer_id": "c586066b-0f29-468f-b775-15483871a202",
    "customer_name": "Alex Smith",
    "customer_email": "alex.smith@example.com",
    "customer_phone": "+15559876543",
    "customer_country": "USA",
    "customer_type": "individual",
    "customer_status": "active",
    "created_at": "2026-04-02T10:00:00.000000Z",
    "updated_at": "2026-04-02T14:00:00.000000Z"
  }
}