---
title: "Create invitation"
method: POST
path: "/api/sites/multiscreen/{site_name}/membership/invitations"
tags: ["Invitations API"]
---

# Create invitation

`POST /api/sites/multiscreen/{site_name}/membership/invitations`

## Request

- Base URL: `https://api.duda.co`
- URL: `https://api.duda.co/api/sites/multiscreen/{site_name}/membership/invitations`
- Auth: HTTP basic

Creates a new invitation and notifies the invited user by email.

## Path parameters

- `site_name` string, required

## Request body

- ApiCreateInvitationRequest
  - `email` string: Email of the user to invite to the site. This email will be notified about the invitation to join the site. User should log in to the site with this email to be added to the groups.
  - `groups` GroupRefById[]: Groups ids, to which the user will be added after logging in.
    - `id` string: Group id

## Response `200`

OK

- ApiInvitationResponse
  - `created` string: Invitation creation ISO date-time
  - `email` string: Email associated with the invitation
  - `groups` ApiGroupRelationResponse[]
    - `id` string: Group id
    - `name` string: Name of the group
  - `id` string: Invitation id

## Other responses

- `400`: Bad request. The request is malformed or failed validation.
- `401`: Unauthorized. The credentials are missing or invalid.
- `429`: Too many requests. The rate limit was exceeded.

---

[API](https://skmtc.dev/duda/apis/duda-partner-api.md) - [All operations](https://skmtc.dev/duda/apis/duda-partner-api/llms.txt) - [OpenAPI document](https://skmtc.dev/duda/apis/duda-partner-api/revisions/52be4d41cb12?raw)