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

# Batch create invitations

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

## Request

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

Creates multiple invitations in a single request. Has a custom rate-limit of 10 calls per minute.

## Path parameters

- `site_name` string, required

## Request body

- ApiBatchCreateInvitationsRequest
  - `invitations` ApiCreateInvitationRequest[]: List of invitations to create
    - `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

- ApiBatchCreateInvitationsResponse
  - `invitations` 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)