Skip to content

Documentation for Guild Join Requests, aka Server Member Applications #8531

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
colinloretz wants to merge 7 commits into
base: main
Choose a base branch
from
+342 −0
Open

Documentation for Guild Join Requests, aka Server Member Applications #8531

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
96868b0
Add MEMBER_VERIFICATION_MANUAL_APPROVAL feature
colinloretz Aug 6, 2026
e8f40d0
Add join request gw events
colinloretz Aug 6, 2026
3435140
Guild Join Request resource
colinloretz Aug 6, 2026
eb2a35d
Add change log
colinloretz Aug 6, 2026
5eeebd3
Remove member screening link
colinloretz Aug 7, 2026
7834a5c
Bump date
colinloretz Aug 7, 2026
99492e6
Rename & link to Server Member Application hc article
colinloretz Aug 7, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 21 additions & 0 deletions developers/change-log.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,27 @@ rss: true

import {Route} from '/snippets/route.jsx'

<Update label="August 10, 2026" tags={["HTTP API", "Gateway"]} rss={{
title: "Guild Join Requests",
description: "Apps can now list and review the membership applications submitted to guilds that require manual approval, and receive Gateway events as those applications change."
}}>
## Guild Join Requests now available via the API

Guilds that have [Server Member Applications](https://support.discord.com/hc/en-us/articles/29729107418519-Server-Member-Applications) set up with manual approval require prospective members to submit a join request.

Discord apps can now review those requests with the [Guild Join Request](/developers/resources/guild-join-request) resource and endpoints:

- **[List Guild Join Requests](/developers/resources/guild-join-request#list-guild-join-requests)**: Return a guild's join requests, filtered by application status.
- **[Action Guild Join Request](/developers/resources/guild-join-request#action-guild-join-request)**: Approve or reject a join request.

Apps can also subscribe to requests in real time with Guild Join Request Gateway events, which are sent under the `GUILD_MODERATION` Intent:
- [Guild Join Request Create](/developers/events/gateway-events#guild-join-request-create)
- [Guild Join Request Update](/developers/events/gateway-events#guild-join-request-update)
- [Guild Join Request Delete](/developers/events/gateway-events#guild-join-request-delete)

These endpoints and events require the `KICK_MEMBERS` permission, and the guild must have both the `MEMBER_VERIFICATION_GATE_ENABLED` and `MEMBER_VERIFICATION_MANUAL_APPROVAL` [features](/developers/resources/guild#guild-object-guild-features).
</Update>

<Update label="August 5, 2026" tags={["Interactions", "Components"]} rss={{
title: "Filter File Types in File Uploads and Attachment Options",
description: "File Upload components and ATTACHMENT command options now accept a file_types array that restricts which files a user can upload."
Expand Down
54 changes: 54 additions & 0 deletions developers/events/gateway-events.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -383,6 +383,9 @@ Receive events are Gateway events encapsulated in an [event payload](/developers
| [Guild Emojis Update](/developers/events/gateway-events#guild-emojis-update) | Guild emojis were updated |
| [Guild Stickers Update](/developers/events/gateway-events#guild-stickers-update) | Guild stickers were updated |
| [Guild Integrations Update](/developers/events/gateway-events#guild-integrations-update) | Guild integration was updated |
| [Guild Join Request Create](/developers/events/gateway-events#guild-join-request-create) | User submitted a join request to a guild |
| [Guild Join Request Update](/developers/events/gateway-events#guild-join-request-update) | Join request to a guild was updated |
| [Guild Join Request Delete](/developers/events/gateway-events#guild-join-request-delete) | Join request to a guild was deleted |
| [Guild Member Add](/developers/events/gateway-events#guild-member-add) | New user joined a guild |
| [Guild Member Remove](/developers/events/gateway-events#guild-member-remove) | User was removed from a guild |
| [Guild Member Update](/developers/events/gateway-events#guild-member-update) | Guild member was updated |
Expand Down Expand Up @@ -840,6 +843,57 @@ Sent when a guild integration is updated.
|----------|-----------|-------------------------------------------------|
| guild_id | snowflake | ID of the guild whose integrations were updated |

#### Guild Join Request Create

<Warning>
If using [Gateway Intents](/developers/events/gateway#gateway-intents), the `GUILD_MODERATION` intent will be required to receive this event.

@Jiralite Jiralite Aug 8, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The "If" part here is inconsistent with intents declared elsewhere:

discord-api-docs/developers/change-log.mdx

Line 533 in f36e7ca

This endpoint requires the `READ_MESSAGE_HISTORY` permission and the `MESSAGE_CONTENT` [Privileged Intent](/developers/events/gateway#privileged-intents).

discord-api-docs/developers/resources/guild.mdx

Lines 985 to 987 in f36e7ca

<Warning>
This endpoint requires the `GUILD_MEMBERS` [Privileged Intent](/developers/events/gateway#privileged-intents).
</Warning>

The documentation is written for API v10 in mind, no?

</Warning>

Sent when a user submits a new [join request](/developers/resources/guild-join-request#guild-join-request-object) to a guild. This event is only sent to bots with the `KICK_MEMBERS` permission.

<ManualAnchor id="guild-join-request-create-guild-join-request-create-event-fields" />
###### Guild Join Request Create Event Fields

| Field | Type | Description |
|----------|---------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------|
| guild_id | snowflake | ID of the guild |
| status | string | [application status](/developers/resources/guild-join-request#guild-join-request-object-application-status) of the join request |
| request | a [guild join request](/developers/resources/guild-join-request#guild-join-request-object) object | The join request that was created |

#### Guild Join Request Update

<Warning>
If using [Gateway Intents](/developers/events/gateway#gateway-intents), the `GUILD_MODERATION` intent will be required to receive this event.
</Warning>

Sent when a [join request](/developers/resources/guild-join-request#guild-join-request-object) is updated, such as when a user submits a request they had already started, or when a request is approved or rejected. This event is only sent to bots with the `KICK_MEMBERS` permission.

<ManualAnchor id="guild-join-request-update-guild-join-request-update-event-fields" />
###### Guild Join Request Update Event Fields

| Field | Type | Description |
|----------|---------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------|
| guild_id | snowflake | ID of the guild |
| status | string | [application status](/developers/resources/guild-join-request#guild-join-request-object-application-status) of the join request |
| request | a [guild join request](/developers/resources/guild-join-request#guild-join-request-object) object | The join request that was updated |

#### Guild Join Request Delete

<Warning>
If using [Gateway Intents](/developers/events/gateway#gateway-intents), the `GUILD_MODERATION` intent will be required to receive this event.
</Warning>

Sent when a [join request](/developers/resources/guild-join-request#guild-join-request-object) is deleted, such as when the applicant withdraws it. This event is only sent to bots with the `KICK_MEMBERS` permission.

<ManualAnchor id="guild-join-request-delete-guild-join-request-delete-event-fields" />
###### Guild Join Request Delete Event Fields

| Field | Type | Description |
|----------|-----------|----------------------------|
| id | snowflake | ID of the join request |
| guild_id | snowflake | ID of the guild |
| user_id | snowflake | ID of the user who applied |

#### Guild Member Add

<Warning>
Expand Down
3 changes: 3 additions & 0 deletions developers/events/gateway.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -341,6 +341,9 @@ GUILD_MODERATION (1 << 2)
- GUILD_AUDIT_LOG_ENTRY_CREATE
- GUILD_BAN_ADD
- GUILD_BAN_REMOVE
- GUILD_JOIN_REQUEST_CREATE
- GUILD_JOIN_REQUEST_UPDATE
- GUILD_JOIN_REQUEST_DELETE

GUILD_EXPRESSIONS (1 << 3)
- GUILD_EMOJIS_UPDATE
Expand Down
Loading