---
title: "Create Invite"
method: POST
path: "/channels/{target}/invites"
tags: ["Channel Invites"]
---

# Create Invite

`POST /channels/{target}/invites`

Creates an invite to this channel.

Channel must be a `TextChannel`.

## Path parameters

- `target` string, required

## Headers

- `X-Audit-Log-Reason` string

## Response `200`

- union — Invite
  - object — Invite to a specific server channel
    - `type` 'Server', required
    - `_id` string, required — Invite code
    - `server` string, required — Id of the server this invite points to
    - `creator` string, required — Id of user who created this invite
    - `channel` string, required — Id of the server channel this invite points to
  - object — Invite to a group channel
    - `type` 'Group', required
    - `_id` string, required — Invite code
    - `creator` string, required — Id of user who created this invite
    - `channel` string, required — Id of the group channel this invite points to

## Other responses

- `default` — An error occurred.

## Changes

- **2026-08-27** `a09d9d97fec9` — 1 info
  - added the required property `oneOf[subschema #2]/locale` to the response with the `default` status
- **2026-08-25** `66efa81c8e1f` — 1 breaking
  - added `subschema #2` to the response body `oneOf` list for the response status `default`
- **2026-07-26** `7a23c8b93766` — 1 breaking, 1 info
  - added `subschema #65, subschema #66, subschema #67, subschema #81, subschema #82, subschema #83, subschema #84, subschema #85, subschema #86, subschema #87, subschema #88, subschema #89, subschema #90, subschema #91, subschema #92, subschema #93, subschema #94, subschema #95` to the response body `oneOf` list for the response status `default`
  - added the new optional `header` request parameter `X-Audit-Log-Reason`

[Change history](https://skmtc.dev/revolt/apis/revolt-api/changes/channels/:target/invites/post.md)

---

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