Skip to content
Quenza
MCPNew: use this help center in Claude, ChatGPT or CursorConnect →

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.

PATCHhttps://developers.quenza.com/v1/clients/{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.

Path parameters

  • clientstringRequired

    The client’s ID, such as 8GJ4D9KQ.

Request body

  • emailstring

    New email address. It must not belong to another client in your workspace.

    Up to 255 characters. A valid email address.

  • first_namestring

    First name.

    Up to 255 characters.

  • last_namestring

    Last name.

    Up to 255 characters.

  • phonestringor null

    Phone number as free text, such as +31 6 1234 5678, or null.

    Up to 50 characters.

  • genderstring

    Gender, or null to clear it.

    One of male, female, other.

  • gender_identitystringor null

    How the client describes their gender, as free text, or null to clear it.

    Up to 255 characters.

  • birthdatestringor 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.

  • timezonestring

    Time zone as an IANA name, such as Europe/Amsterdam. Cannot be null.

    One of 419 values, listed in the OpenAPI file.

Response

200 with the client in data:

  • idstring

    The client’s ID. Use it in the URL of the other client endpoints and to add the client to a group.

  • emailstring

    Email address, unique in your workspace.

  • first_namestring

    First name.

  • last_namestring

    Last name.

  • statusstring

    pending until the client accepts the invitation, then active. archived after you archive the client.

    One of active, pending, archived.

  • is_guestboolean

    Whether the client is a guest without a login. Clients created through the API are never guests.

  • timezonestring

    Time zone as an IANA name, such as Europe/Amsterdam.

  • phonestringor null

    Phone number as free text, such as +31 6 1234 5678, or null.

  • genderstringor null

    Gender, or null.

    One of male, female, other.

  • gender_identitystringor null

    How the client describes their gender, as free text, or null.

  • birthdatestringor null

    Date of birth as YYYY-MM-DD, or null.

    Format YYYY-MM-DD.

  • invited_atstringor null

    When the invitation email was sent.

    ISO 8601 date and time in UTC.

  • invitation_accepted_atstringor null

    When the invitation was accepted, or null while it is pending.

    ISO 8601 date and time in UTC.

  • archived_atstringor null

    When it was archived, or null.

    ISO 8601 date and time in UTC.

  • created_atstring

    When it was created.

    ISO 8601 date and time in UTC.

  • updated_atstring

    When it was last changed.

    ISO 8601 date and time in UTC.

Status codes

Enlarged screenshot from this article