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

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

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](https://quenza.com/help/billing/professional-seats/).

[Add team members](https://quenza.com/help/team/add-team-members/) explains the same in the app.

## Request

`POST https://developers.quenza.com/v1/members`

### Request body

- `email` (string, required): 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_name` (string, required): First name. Up to 255 characters
- `last_name` (string, required): Last name. Up to 255 characters
- `role` (string, required): `member` or `manager`. Owners and billing managers cannot be added through the API. One of `member`, `manager`
- `timezone` (string, or 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](https://quenza.com/help/api/openapi.json)
- `language_code` (string, or null): Language of the invitation and the app. Defaults to English (`en`). One of `de`, `nl`, `en`, `es`, `fr`, `it`, `pt`, `fi`
- `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 POST https://developers.quenza.com/v1/members \
  -H "Authorization: Bearer $QUENZA_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "daniel.weber@example.com",
    "first_name": "Daniel",
    "last_name": "Weber",
    "role": "member",
    "timezone": "Europe/Amsterdam"
  }'
```

## Response

201 Created.

### 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": null,
    "company": "Bright Path Coaching",
    "website": "https://example.com",
    "address": null,
    "city": "Amsterdam",
    "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:10:00.000000Z"
  }
}
```

Status codes: 201 Created, 401 Unauthenticated, 402 Workspace not active, 403 Not on your plan, 406 Not acceptable, 415 Wrong content type, 422 Validation error. See /help/api/errors/.
