Update a Customer

Update the information of a specific customer by phone number. Only the fields included in the request are modified.

PATCH https://api.platica.mx/v1/clients/{id}

URL parameters

Parameter	Type	Description	Required
`id`	string	Customer phone number in E.164 format without `+`, or the customer ID	✓

All fields are optional. Only the fields included are updated.

Field	Type	Description
`name`	string	Customer full name
`firstname`	string	Customer first name
`lastname`	string	Customer last name
`email`	string	Customer email
`birthdate`	string	Date of birth. Format: `dd/mm/yyyy`
`gender`	enum	Gender: `male` or `female`
`company`	string	Company name
`country`	enum	Country of residence (ISO 3166-1 alpha-2 code)
`state`	string	State of residence
`city`	string	City of residence
`address`	string	Full address
`postalCode`	string	Postal code
`tags`	array	Array of tags
`customFields`	object	Custom fields
`owners`	array	List of responsible-user emails
`status`	enum	Customer status: `active` or `blocked`

owners must be sent as a list of email addresses
each email must exist as a workspace user
tags are combined with existing tags without duplicates
customFields are merged with existing ones
in customFields, for a select field send the option id or its label (the id is stored); a value that does not match any active option returns 400, and null or "" clears the value
the phoneNumber from the path is normalized and kept as the customer identifier

{
  "name": "José",
  "email": "jose@platica.mx",
  "tags": ["vip"],
  "customFields": {
    "placas": "ABC123",
    "id_recepcion": "REC001"
  }
}

{
  "status": "success",
  "message": "Client updated successfully",
  "data": {
    "id": "274fc73cb7d84a17955914fdc1a1f9d0"
  }
}

Consejo

Only the fields included in the request body are updated. Fields that are not included keep their current values.