Create event invite
discord_
Write
- Toolset
- Scheduled events
scheduled_events - Discord permission
- Create Instant Invite
- Context cost
- 413 tokens, estimated1,651 bytes of definition, divided by 4
Create a shareable invite URL that points to a scheduled event, so recipients land on the event when joining. Requires the Create Instant Invite permission. Returns the invite URL; Discord may reuse a similar existing invite instead of creating a new one. EXTERNAL events need channel_id; other events reject it and use their own channel. The URL is an ordinary channel invite with ?event=<event ID> appended. Use discord_ for a channel invite with the unique or temporary options.
Risk and annotations
Read-onlyreadOnlyHint | no | Can modify your server. |
|---|---|---|
DestructivedestructiveHint | no | Declared non-destructive. |
IdempotentidempotentHint | no | Repeating the call can have an additional effect. |
Open worldopenWorldHint | yes | Interacts with an external system: Discord. |
Annotations are hints the server declares. Clients use them to decide when to ask you before a call.
Parameters
| Parameter | Type | Rules | Description |
|---|---|---|---|
| guild_ | string | pattern ^\d{17,20}$ | Discord server (guild) ID (snowflake). |
| event_ | string | pattern ^\d{17,20}$ | ID (snowflake) of the scheduled event to link the invite to. |
| channel_ | string | pattern ^\d{17,20}$ | Channel (snowflake) the invite points to. Required for EXTERNAL events, which have no channel of their own. Omit it for VOICE and STAGE_INSTANCE events: they always use their own channel, and passing one fails. |
| max_ | integer | 0 to 604800default 86400 | Invite lifetime in seconds, 0–604800 (7 days); 0 means it never expires. Default 86400 (24h). |
| max_ | integer | 0 to 100default 0 | Maximum number of uses, 0–100; 0 means unlimited. Default 0. |
Output
This tool declares no output schema. Its description says what it returns; this page shows no example rather than invent one.
Related tools
Named in its description
Also in Scheduled events
-
List scheduled events, Read-only
discord_list_ scheduled_ events -
Get scheduled event, Read-only
discord_get_ scheduled_ event -
Create scheduled event, Write
discord_create_ scheduled_ event -
Edit scheduled event, Write
discord_edit_ scheduled_ event -
Delete scheduled event, Destructive
discord_delete_ scheduled_ event -
Get event subscribers, Read-only
discord_get_ event_ subscribers
Raw definition (1,651 bytes)
{
"name": "discord_create_event_invite",
"description": "Create a shareable invite URL that points to a scheduled event, so recipients land on the event when joining. Requires the Create Instant Invite permission. Returns the invite URL; Discord may reuse a similar existing invite instead of creating a new one. EXTERNAL events need channel_id; other events reject it and use their own channel. The URL is an ordinary channel invite with ?event=<event ID> appended. Use discord_create_invite for a channel invite with the unique or temporary options.",
"inputSchema": {
"type": "object",
"properties": {
"guild_id": {
"type": "string",
"pattern": "^\\d{17,20}$",
"description": "Discord server (guild) ID (snowflake)."
},
"event_id": {
"type": "string",
"pattern": "^\\d{17,20}$",
"description": "ID (snowflake) of the scheduled event to link the invite to."
},
"channel_id": {
"description": "Channel (snowflake) the invite points to. Required for EXTERNAL events, which have no channel of their own. Omit it for VOICE and STAGE_INSTANCE events: they always use their own channel, and passing one fails.",
"type": "string",
"pattern": "^\\d{17,20}$"
},
"max_age": {
"default": 86400,
"description": "Invite lifetime in seconds, 0–604800 (7 days); 0 means it never expires. Default 86400 (24h).",
"type": "integer",
"minimum": 0,
"maximum": 604800
},
"max_uses": {
"default": 0,
"description": "Maximum number of uses, 0–100; 0 means unlimited. Default 0.",
"type": "integer",
"minimum": 0,
"maximum": 100
}
},
"required": [
"guild_id",
"event_id"
],
"additionalProperties": false
},
"annotations": {
"title": "Create event invite",
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": false,
"openWorldHint": true
}
}