---
title: "Create invitation"
method: POST
path: "/v1/invitations"
tags: ["User management"]
---

# Create invitation

`POST /v1/invitations`

This API invites a new user to your organization by email. If the email has been invited before, the existing invitation is refreshed with a new expiration date.

> 👍 Tip: 
  > The invitation is valid for 7 days. If the user does not accept the invitation within that time frame, they will need to be re-invited.

## Request body

- object
  - `email` string, email, required — Email address of the invitee.
  - `first_name` string, required — Invitee's first name.
  - `last_name` string, required — Invitee's last name.
  - `is_manager` boolean — Whether to invite as a manager. Managers have additional permissions in the system, such as the ability to view and manage users and invitations. Defaults to `false`.

## Response `201`

Invitation created (or refreshed) successfully

- SuccessCreateInvitationsSchema — Schema for the successful response of creating an invitation.
  - `email` string, email — Email address of the invited user.
  - `first_name` string, nullable — First name of the invited user.
  - `last_name` string, nullable — Last name of the invited user.
  - `is_manager` boolean — Indicates whether the invited user was granted manager permissions.
  - `invited_by_account_pk` integer, nullable — A unique identifier of the user who sent the invitation.
  - `created_at` string, date-time — Timestamp indicating when the invitation was created.
  - `expires_at` string, date-time — Timestamp indicating when the invitation expires.

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `412` — Precondition failed
- `500` — Internal server error

---

[API](https://skmtc.net/ocrolus/apis/user-management.md) · [All operations](https://skmtc.net/ocrolus/apis/user-management/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ocrolus/user-management/versions/3571ef602d13/schema)