---
title: "Create a project invitation"
method: POST
path: "/api/projects/{projectId}/invitations"
tags: ["Members"]
---

# Create a project invitation

`POST /api/projects/{projectId}/invitations`

Create a project invitation. Accepts a JSON request body when defined and returns the resulting resource or action status.

## Path parameters

- `projectId` string, required

## Request body

- CreateInvitationRequest — create Invitation Request payload accepted by the API.
  - `email` string, required — Email address associated with a user or invitation.
  - `role` string, required — Project role assigned to a member or invitation.

## Response `200`

Invitation

- Invitation — invitation API object.
  - `token` string — Opaque invitation or authentication token.
  - `email` string — Email address associated with a user or invitation.
  - `role` string — Project role assigned to a member or invitation.

---

[API](https://skmtc.dev/ibuildthecloud/apis/discobot-server-api.md) · [All operations](https://skmtc.dev/ibuildthecloud/apis/discobot-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ibuildthecloud/discobot-server-api/revisions/4de3fcd6be56/schema)