# Update a client

> Change a client's name, email, phone number, birthdate or time zone through the Quenza API. Only the fields you send are changed.

Source: https://quenza.com/help/api/clients/update-a-client/

Send only the fields you want to change; the others stay as they are. To clear an optional field, such as the phone number, send `null`.

The client’s language cannot be changed through the API. A new email address must not belong to another client in your workspace.

## Request

`PATCH https://developers.quenza.com/v1/clients/{client}`

### Path parameters

- `client` (string, required): The client’s ID, such as `8GJ4D9KQ`.

### Request body

- `email` (string): New email address. It must not belong to another client in your workspace. Up to 255 characters. A valid email address
- `first_name` (string): First name. Up to 255 characters
- `last_name` (string): Last name. Up to 255 characters
- `phone` (string, or null): Phone number as free text, such as `+31 6 1234 5678`, or `null`. Up to 50 characters
- `gender` (string): Gender, or `null` to clear it. One of `male`, `female`, `other`
- `gender_identity` (string, or null): How the client describes their gender, as free text, or `null` to clear it. Up to 255 characters
- `birthdate` (string, or null): Date of birth as `YYYY-MM-DD`, at most 120 years ago and before today, or `null` to clear it. Format `YYYY-MM-DD`
- `timezone` (string): Time zone as an IANA name, such as `Europe/Amsterdam`. Cannot be `null`. One of 419 values, listed in the [OpenAPI file](https://quenza.com/help/api/openapi.json)

### Example

```bash
curl -X PATCH https://developers.quenza.com/v1/clients/8GJ4D9KQ \
  -H "Authorization: Bearer $QUENZA_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+31 6 9876 5432"
  }'
```

## Response

200 OK.

### Fields of data

- `id` (string): The client’s ID. Use it in the URL of the other client endpoints and to add the client to a group.
- `email` (string): Email address, unique in your workspace.
- `first_name` (string): First name.
- `last_name` (string): Last name.
- `status` (string): `pending` until the client accepts the invitation, then `active`. `archived` after you archive the client. One of `active`, `pending`, `archived`
- `is_guest` (boolean): Whether the client is a guest without a login. Clients created through the API are never guests.
- `timezone` (string): Time zone as an IANA name, such as `Europe/Amsterdam`.
- `phone` (string, or null): Phone number as free text, such as `+31 6 1234 5678`, or `null`.
- `gender` (string, or null): Gender, or `null`. One of `male`, `female`, `other`
- `gender_identity` (string, or null): How the client describes their gender, as free text, or `null`.
- `birthdate` (string, or null): Date of birth as `YYYY-MM-DD`, or `null`. Format `YYYY-MM-DD`
- `invited_at` (string, or null): When the invitation email was sent. ISO 8601 date and time in UTC
- `invitation_accepted_at` (string, or null): When the invitation was accepted, or `null` while it is pending. ISO 8601 date and time in UTC
- `archived_at` (string, or null): When it was archived, or `null`. ISO 8601 date and time in UTC
- `created_at` (string): When it was created. ISO 8601 date and time in UTC
- `updated_at` (string): When it was last changed. ISO 8601 date and time in UTC

```json
{
  "data": {
    "id": "8GJ4D9KQ",
    "email": "emma.clarke@example.com",
    "first_name": "Emma",
    "last_name": "Clarke",
    "status": "active",
    "is_guest": false,
    "timezone": "Europe/Amsterdam",
    "phone": "+31 6 9876 5432",
    "gender": "female",
    "gender_identity": null,
    "birthdate": "1991-04-12",
    "invited_at": "2026-09-02T08:15:00.000000Z",
    "invitation_accepted_at": "2026-09-02T19:40:12.000000Z",
    "archived_at": null,
    "created_at": "2026-09-02T08:15:00.000000Z",
    "updated_at": "2026-11-15T10:20:00.000000Z"
  }
}
```

Status codes: 200 OK, 401 Unauthenticated, 402 Workspace not active, 403 Not on your plan, 404 Not found, 406 Not acceptable, 415 Wrong content type, 422 Validation error. See /help/api/errors/.
