---
title: "Invite a New User"
method: POST
path: "/management/v1/projects/users/invite"
tags: ["Management"]
---

# Invite a New User

`POST /management/v1/projects/users/invite`

Sends an invitation to an email address that has not been used yet as a Voucherify user login.

You can specify the projects to which the invited user will be assigned and define their roles.

## Request body

- ManagementProjectsUsersInviteCreateRequestBody — Request body schema for **POST** `/management/v1/projects/users/invite`.
  - `email` string, required — Email address to which the invitation will be sent. Must be a valid email address.
  - `first_name` string, required — First name of the person who will receive the invitation. The name will be used in the user profile.
  - `last_name` string, required — Last name of the person who will receive the invitation. The name will be used in the user profile.
  - `projects` object, required — In the key, provide the project ID to which the new user will be assigned. In the value, provide the role which the user will have in the project. The predefined Voucherify roles are: `ADMIN`, `USER`, `VIEWER`, `MERCHANT`, `USER_RESTRICTED` (for the Areas and Stores, an Enterprise feature). Send a custom role ID (Enterprise feature) to assign a custom role. To find the custom role ID: If you are an admin, go to Voucherify Dashboard, Team settings, and Roles tab. Click on a custom role. The custom role ID is in the URL in the format `role_XyZ7aB9cD2eF4gH1iJ0kL5mN6oP8qR3s`.

## Response `204`

Returns no content if the invitation has been sent successfully.

## Other responses

- `400` — Returns an error if the payload includes an incorrect role.
- `404` — Returns an error if the project does not exist or has been deleted.
- `409` — Returns an error if the email address belongs to a Voucherify user.

---

[API](https://skmtc.net/voucherifyio/apis/voucherify-api-async-actions.md) · [All operations](https://skmtc.net/voucherifyio/apis/voucherify-api-async-actions/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/voucherifyio/voucherify-api-async-actions/revisions/4982266e0494/schema)