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

Create a member

Invite a professional to your Quenza team through the API as a member or manager. Quenza sends their invitation email and uses a seat.

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

Creates the member and sends them an invitation email. Until they accept it, their status is pending.

  • Only the roles member and manager can be given through the API. Make someone an owner or billing manager in Quenza.
  • Every member uses a professional seat of your plan. When all seats are taken, the request fails with 422 and Limit reached; see Professional seats.

Add team members explains the same in the app.

Request body

  • emailstringRequired

    Quenza sends the invitation to this address. It must not belong to another member of 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.

  • rolestringRequired

    member or manager. Owners and billing managers cannot be added through the API.

    One of member, manager.

  • 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 app. Defaults to English (en).

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

  • companystringor null

    Company or practice name, or null.

    Up to 255 characters.

  • websitestringor null

    Website address, such as https://example.com, or null.

    Up to 255 characters. A full URL.

  • addressstringor null

    Street and house number, or null.

    Up to 255 characters.

  • citystringor null

    City, or null.

    Up to 255 characters.

  • statestringor null

    State or region, or null.

    Up to 255 characters.

  • country_codestringor null

    Two-letter country code in lower case, such as nl, or null.

    One of 210 values, listed in the OpenAPI file.

Response

201 with the member in data:

  • idstring

    The member’s ID. Use it to update the member or to find their tasks.

  • emailstring

    Email address.

  • first_namestring

    First name.

  • last_namestring

    Last name.

  • statusstring

    pending until the member accepts the invitation, then active. suspended while the member is suspended.

    One of active, pending, suspended.

  • rolestring

    Role in the workspace.

    One of owner, manager, billing_manager, member.

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

  • companystringor null

    Company or practice name, or null.

  • websitestringor null

    Website address, such as https://example.com, or null.

  • addressstringor null

    Street and house number, or null.

  • citystringor null

    City, or null.

  • statestringor null

    State or region, or null.

  • country_codestringor null

    Two-letter country code in lower case, such as nl, or null.

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

  • 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