---
title: "Create multiple invites"
method: POST
path: "/invites/create-multiple.json"
tags: ["Invites"]
---

# Create multiple invites

`POST /invites/create-multiple.json`

## Headers

- `Api-Key` string, required
- `Api-Username` string, required

## Request body

- object
  - `email` string — pass 1 email per invite to be generated. other properties will be shared by each invite.
  - `skip_email` boolean
  - `custom_message` string — optional, for email invites
  - `max_redemptions_allowed` integer — optional, for link invites
  - `topic_id` integer
  - `group_ids` string — Optional, either this or `group_names`. Comma separated list for multiple ids.
  - `group_names` string — Optional, either this or `group_ids`. Comma separated list for multiple names.
  - `expires_at` string — optional, if not supplied, the invite_expiry_days site setting is used

## Response `200`

success response

- object
  - `num_successfully_created_invitations` integer
  - `num_failed_invitations` integer
  - `failed_invitations` unknown[]
    - unknown
  - `successful_invitations` unknown[]
    - unknown

---

[API](https://skmtc.dev/discourse/apis/discourse-api-documentation.md) · [All operations](https://skmtc.dev/discourse/apis/discourse-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/discourse/discourse-api-documentation/revisions/2fd8fd2d6fd0/schema)