# Update a member

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

Source: https://quenza.com/help/api/members/update-a-member/

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

A member's role cannot be changed through the API. Change it in Quenza; see [Roles and permissions](https://quenza.com/help/team/roles-and-permissions/).

## Request

`PATCH https://developers.quenza.com/v1/members/{professional}`

### Path parameters

- `professional` (string, required): The member’s ID.

### Request body

- `first_name` (string): First name. Up to 255 characters
- `last_name` (string): Last name. Up to 255 characters
- `email` (string): New email address. Up to 255 characters. A valid email address
- `timezone` (string, or null): Time zone as an IANA name, such as `Europe/Amsterdam`. One of 419 values, listed in the [OpenAPI file](https://quenza.com/help/api/openapi.json)
- `phone` (string, or null): Phone number as free text, such as `+31 6 1234 5678`, or `null`. Up to 50 characters
- `company` (string, or null): Company or practice name, or `null`. Up to 255 characters
- `website` (string, or null): Website address, such as `https://example.com`, or `null`. Up to 255 characters. A full URL
- `address` (string, or null): Street and house number, or `null`. Up to 255 characters
- `city` (string, or null): City, or `null`. Up to 255 characters
- `state` (string, or null): State or region, or `null`. Up to 255 characters
- `country_code` (string, or null): Two-letter country code in lower case, such as `nl`, or `null`. One of 210 values, listed in the [OpenAPI file](https://quenza.com/help/api/openapi.json)

### Example

```bash
curl -X PATCH https://developers.quenza.com/v1/members/K9T3W6PB \
  -H "Authorization: Bearer $QUENZA_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "city": "Utrecht",
    "phone": "+31 30 555 0199"
  }'
```

## Response

200 OK.

### Fields of data

- `id` (string): The member’s ID. Use it to update the member or to find their tasks.
- `email` (string): Email address.
- `first_name` (string): First name.
- `last_name` (string): Last name.
- `status` (string): `pending` until the member accepts the invitation, then `active`. `suspended` while the member is suspended. One of `active`, `pending`, `suspended`
- `role` (string): Role in the workspace. One of `owner`, `manager`, `billing_manager`, `member`
- `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`.
- `company` (string, or null): Company or practice name, or `null`.
- `website` (string, or null): Website address, such as `https://example.com`, or `null`.
- `address` (string, or null): Street and house number, or `null`.
- `city` (string, or null): City, or `null`.
- `state` (string, or null): State or region, or `null`.
- `country_code` (string, or null): Two-letter country code in lower case, such as `nl`, or `null`.
- `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
- `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": "K9T3W6PB",
    "email": "daniel.weber@example.com",
    "first_name": "Daniel",
    "last_name": "Weber",
    "status": "pending",
    "role": "member",
    "timezone": "Europe/Amsterdam",
    "phone": "+31 30 555 0199",
    "company": "Bright Path Coaching",
    "website": "https://example.com",
    "address": null,
    "city": "Utrecht",
    "state": null,
    "country_code": "nl",
    "invited_at": "2026-11-15T10:10:00.000000Z",
    "invitation_accepted_at": null,
    "created_at": "2026-11-15T10:10:00.000000Z",
    "updated_at": "2026-11-15T10:30: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/.
