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

Create a client

Add a client to your Quenza workspace through the API. Quenza sends their invitation email and assigns them to the token's professional.

POSThttps://developers.quenza.com/v1/clients

Creates the client and sends them an invitation email to set up their account, in the language you choose. Until they accept it, their status is pending.

What else happens:

  • The client is assigned to the professional who owns the API token.
  • The Client Created webhook fires, like for a client you add by hand.
  • The client counts towards your plan’s client limit. When all places are taken, the request fails with 422 and Limit reached; see Errors.

An email address can belong to only one client in your workspace. Sync clients from your CRM shows what to do when it is taken.

Request body

  • emailstringRequired

    Quenza sends the invitation to this address. It must not belong to another client in your workspace.

    Up to 255 characters. A valid email address.

  • first_namestringRequired

    First name.

    Up to 255 characters.

  • last_namestringRequired

    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.

    One of male, female, other.

  • gender_identitystringor null

    How the client describes their gender, as free text.

    Up to 255 characters.

  • birthdatestringor null

    Date of birth as YYYY-MM-DD, before today.

    Format YYYY-MM-DD.

  • timezonestringor null

    Time zone as an IANA name, such as Europe/Amsterdam. Defaults to the time zone of the professional who owns the API token.

    One of 419 values, listed in the OpenAPI file.

  • language_codestringor null

    Language of the invitation and the client app. Defaults to English (en).

    One of de, nl, en, es, fr, it, pt, fi.

Response

201 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