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

# Create an invite

`POST /invites.json`

## Headers

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

## Request body

- object
  - `email` string — required for email invites only
  - `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
  - `id` integer, required
  - `invite_key` string, required
  - `link` string, required
  - `description` string, nullable, required
  - `email` string, required
  - `domain` string, nullable, required
  - `emailed` boolean, required
  - `can_delete_invite` boolean, required
  - `custom_message` string, nullable, required
  - `created_at` string, required
  - `updated_at` string, required
  - `expires_at` string, required
  - `expired` boolean, required
  - `grants_admin` boolean, required
  - `grants_moderator` boolean, required
  - `topics` object[], required
  - `groups` object[], required

## Changes

> 10 revisions in range; 6 could not be searched.

- **2026-07-26** `6be3dcbee910` — 2 info
  - added the required property `grants_admin` to the response with the `200` status
  - added the required property `grants_moderator` to the response with the `200` status

[Change history](https://skmtc.dev/discourse/apis/discourse-api-documentation/changes/invites.json/post.md)

---

[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)