curl -X PUT 'https://api.yativo.com/api/v1/customer/c586066b-0f29-468f-b775-15483871a202' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET' \
-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"
}
}
Customers
Update Customer
Update an existing customer’s profile information
PUT
/
customer
/
{customer_id}
curl -X PUT 'https://api.yativo.com/api/v1/customer/c586066b-0f29-468f-b775-15483871a202' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET' \
-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"
}
}
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.curl -X PUT 'https://api.yativo.com/api/v1/customer/c586066b-0f29-468f-b775-15483871a202' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET' \
-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"
}
}
Authorizations
Your API key (yativo_pk_...) from Developers → API Keys. Send together with X-Api-Secret.
Your API secret (yativo_sk_...), shown once when the key is created.
Headers
A unique string per request to ensure idempotent processing.
Path Parameters
The UUID of the customer to update.
Body
application/json
The customer ID. Must match an existing customer record.
Full name of the customer (individual) or legal business name (business).
Customer's email address.
Customer's phone number.
Customer's country in ISO 3166-1 alpha-3 format (e.g. USA, BRA, MEX).
Customer's address details.
Show child attributes
Show child attributes