Members
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.
Creates the member and sends them an invitation email. Until they accept it, their status is pending.
- Only the roles
memberandmanagercan 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
422andLimit reached; see Professional seats.
Add team members explains the same in the app.
Request body
emailstringRequiredQuenza 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_namestringRequiredFirst name.
Up to 255 characters.
last_namestringRequiredLast name.
Up to 255 characters.
rolestringRequiredmemberormanager. Owners and billing managers cannot be added through the API.One of
member,manager.timezonestringor nullTime 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 nullLanguage of the invitation and the app. Defaults to English (
en).One of
de,nl,en,es,fr,it,pt,fi.companystringor nullCompany or practice name, or
null.Up to 255 characters.
websitestringor nullWebsite address, such as
https://example.com, ornull.Up to 255 characters. A full URL.
addressstringor nullStreet and house number, or
null.Up to 255 characters.
citystringor nullCity, or
null.Up to 255 characters.
statestringor nullState or region, or
null.Up to 255 characters.
country_codestringor nullTwo-letter country code in lower case, such as
nl, ornull.One of 210 values, listed in the OpenAPI file.
Response
201 with the member in data:
idstringThe member’s ID. Use it to update the member or to find their tasks.
emailstringEmail address.
first_namestringFirst name.
last_namestringLast name.
statusstringpendinguntil the member accepts the invitation, thenactive.suspendedwhile the member is suspended.One of
active,pending,suspended.rolestringRole in the workspace.
One of
owner,manager,billing_manager,member.timezonestringTime zone as an IANA name, such as
Europe/Amsterdam.phonestringor nullPhone number as free text, such as
+31 6 1234 5678, ornull.companystringor nullCompany or practice name, or
null.websitestringor nullWebsite address, such as
https://example.com, ornull.addressstringor nullStreet and house number, or
null.citystringor nullCity, or
null.statestringor nullState or region, or
null.country_codestringor nullTwo-letter country code in lower case, such as
nl, ornull.invited_atstringor nullWhen the invitation email was sent.
ISO 8601 date and time in UTC.
invitation_accepted_atstringor nullWhen the invitation was accepted, or
nullwhile it is pending.ISO 8601 date and time in UTC.
created_atstringWhen it was created.
ISO 8601 date and time in UTC.
updated_atstringWhen it was last changed.
ISO 8601 date and time in UTC.
Status codes
Was this article helpful?
Thanks for letting us know.
Thank you. We read every answer and use it to improve this article.