---
title: "Invite a member"
method: POST
path: "/members"
tags: ["Members"]
---

# Invite a member

`POST /members`

Invite a member

## Request body

- object
  - `name` string, required
  - `email` string, email, nullable, required
  - `department_ids` object[], required
    - `id` string, uuid, required
  - `employment_start_date` string, nullable, required — Date/time in ISO 8601 format, e.g. `2026-06-01` (interpreted as UTC midnight) or `2026-06-01T09:00:00Z`. Always include a time zone designator (`Z` for UTC) when sending a time of day. Localized formats such as `01.06.2026` or `06/01/2026` are misinterpreted and must not be used.
  - `public_holiday_id` string, required
  - `annual_allowance_current_year` number, required
  - `annual_allowance_next_year` number, required
  - `birthday` string, nullable, required — Date/time in ISO 8601 format, e.g. `2026-06-01` (interpreted as UTC midnight) or `2026-06-01T09:00:00Z`. Always include a time zone designator (`Z` for UTC) when sending a time of day. Localized formats such as `01.06.2026` or `06/01/2026` are misinterpreted and must not be used.
  - `custom_id` string, nullable, required
  - `defaultAllowances` object[], required — One entry per allowance type the member should get. `default` and `disabled` can be changed later via PUT /members/{member_id}/allowance-type-configurations/{allowance_type_id}.
    - `id` string, required
    - `current_year` number, required
    - `next_year` number, required
    - `default` boolean — Preselect this allowance type for the member. Set it on exactly one entry; if no entry sets it, the member has no preselected type and sees no allowance in the calendar.
    - `disabled` boolean — Hide this allowance type from the member.

## Response `200`

Successful response

- string, uuid

## Other responses

- `400` — Invalid input data
- `401` — Authorization not provided
- `403` — Insufficient access
- `500` — Internal server error

---

[API](https://skmtc.net/absentify/apis/absentify-crud-api.md) · [All operations](https://skmtc.net/absentify/apis/absentify-crud-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/absentify/absentify-crud-api/revisions/ef777d51e6f2/schema)