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	✓

Request body

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`. See Changing the status

Update behavior

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

Changing the status

Sending status is not a profile update like the rest: it runs the same path as Moderate a Customer , including the moderation record and the sync of the customer's open conversations. When you include it, the response also carries status and conversationsUpdated.

You can combine it with profile fields in the same call.

Consejo

This endpoint only accepts the phone number. To block a contact that has no phone — webchat, Instagram, Telegram — use PATCH /v1/clients/{id}/moderation , which accepts the customer ID.

Example request

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

Response

{
  "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.

Previous Create a Customer Next Delete a Customer