v1
latestOpenAPI 3.1.02026-07-2684271522.2 KBCustomers
Update a customer
Updates the specified customer. Only the fields you provide are changed; omitted fields are left unchanged.
patch/v1/customers/{id}
Path parameters
idstring required
Example:fcus_01J9XR8M3K7VZ8N2YB4WJ6T0RA
Request body
Example request
{
"customer": {
"first_name": "John",
"last_name": "Doe",
"email": "joh.doe@example.com",
"phone": "+15555555555",
"employer": "Flex",
"shipping": {},
"metadata": "{\"key\": \"value\"}"
}
}Response
An envelope wrapping a single customer object.
Example response
{
"customer": {
"customer_id": "fcus_01HACM7FZ1084XB1GB6053VM0D",
"owner_partner_id": "obj_01J9XR8M3K7VZ8N2YB4WJ6T0RA",
"first_name": "John",
"last_name": "Doe",
"email": "joh.doe@example.com",
"phone": "+15555555555",
"employer": "Flex",
"shipping": {},
"metadata": {
"order_id": "8842",
"channel": "shopify"
},
"created_at": "2026-06-15T14:30:00Z",
"test_mode": false
}
}