Server settings
Update your server's name, icon, verification level and other settings.
Edit server settings
Edits server-wide settings.
Required permissions: Manage server.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Name | Text | No | New server name. Length: 2 to 100 characters. |
| Verification level | Verification level | No | Required verification level for new members. |
| Content filter | Explicit content filter | No | Explicit content filter setting. |
| Default notifications | Default notifications | No | Default notification setting. |
| Preferred locale | Text | No | Server-preferred locale. |
| Audit log reason | Text | No | Reason recorded in the audit log. Maximum length: 512 characters. |
Fetch audit log entries
Fetches recent entries from the audit log.
Required permissions: View audit log.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Limit | Whole number | Yes | Maximum number of entries to fetch (1 - 100). Value: 1 to 100. Default: 50. |
| Action | Audit log event | No | Only return entries with this action. |
| Executor | User | No | Only return entries performed by this user. |
Outputs
| Name | Type | Details |
|---|---|---|
| Entries | List of Audit log entry | Audit log entries that match the filter. |
Set server name
Update the display name of a server.
Required permissions: Manage server.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Name | Text | Yes | The new server name (2-100 characters). Length: 2 to 100 characters. |
| Audit log reason | Text | No | Reason shown in the audit log. Maximum length: 512 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Server | Server | The updated server. |
Set server icon
Change or remove the server icon.
Required permissions: Manage server.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Icon URL | URL | Yes | URL to the new icon image, or empty to remove. |
| Audit log reason | Text | No | Reason shown in the audit log. Maximum length: 512 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Server | Server | The updated server. |
Set server banner
Change or remove the server banner.
Required permissions: Manage server.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Banner URL | URL | Yes | URL to the new banner image, or empty to remove. |
| Audit log reason | Text | No | Reason shown in the audit log. Maximum length: 512 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Server | Server | The updated server. |
Set invite splash
Change or remove the invite splash image shown on invite links.
Required permissions: Manage server.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Splash URL | URL | Yes | URL to the new splash image, or empty to remove. |
| Audit log reason | Text | No | Reason shown in the audit log. Maximum length: 512 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Server | Server | The updated server. |
Set discovery splash
Change or remove the splash image shown in the discovery directory.
Required permissions: Manage server.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Discovery splash URL | URL | Yes | URL to the new discovery splash image, or empty to remove. |
| Audit log reason | Text | No | Reason shown in the audit log. Maximum length: 512 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Server | Server | The updated server. |
Set system channel
Pick the channel where system messages (joins, boosts) are posted.
Required permissions: Manage server.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| System channel | Text channel | Yes | The text channel for system messages, or empty to disable. |
| Audit log reason | Text | No | Reason shown in the audit log. Maximum length: 512 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Server | Server | The updated server. |
Set system channel flags
Configure which system messages are suppressed in the system channel.
Required permissions: Manage server.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Flags | List of System channel flag | Yes | Flags identifying which system messages to suppress. |
| Audit log reason | Text | No | Reason shown in the audit log. Maximum length: 512 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Server | Server | The updated server. |
Set AFK channel
Pick the voice channel users are moved to when idle.
Required permissions: Manage server.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| AFK channel | Voice channel | Yes | The voice channel for idle members, or empty to disable. |
| Audit log reason | Text | No | Reason shown in the audit log. Maximum length: 512 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Server | Server | The updated server. |
Set AFK timeout
Set how long until idle voice members are moved to the AFK channel.
Required permissions: Manage server.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Timeout | Duration | Yes | The AFK timeout (60s, 5m, 15m, 30m, or 1h). Allowed values: 60, 300, 900, 1800, 3600. |
| Audit log reason | Text | No | Reason shown in the audit log. Maximum length: 512 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Server | Server | The updated server. |
Set rules channel
Designate the channel that displays the server's rules (community servers only).
Required permissions: Manage server.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Rules channel | Text channel | Yes | The text channel containing the rules. |
| Audit log reason | Text | No | Reason shown in the audit log. Maximum length: 512 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Server | Server | The updated server. |
Set public updates channel
Designate the channel that receives Discord community updates (community servers only).
Required permissions: Manage server.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Public updates channel | Text channel | Yes | The text channel for Discord community updates. |
| Audit log reason | Text | No | Reason shown in the audit log. Maximum length: 512 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Server | Server | The updated server. |
Set safety alerts channel
Pick the channel that receives Discord safety notifications.
Required permissions: Manage server.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Safety alerts channel | Text channel | Yes | The text channel for safety alerts. |
| Audit log reason | Text | No | Reason shown in the audit log. Maximum length: 512 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Server | Server | The updated server. |
Set verification level
Adjust how strict the server's verification requirement is for new members.
Required permissions: Manage server.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Verification level | Verification level | Yes | The new verification level. |
| Audit log reason | Text | No | Reason shown in the audit log. Maximum length: 512 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Server | Server | The updated server. |
Set explicit content filter
Configure how Discord scans uploaded media for explicit content.
Required permissions: Manage server.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Filter | Explicit content filter | Yes | The explicit content filter level. |
| Audit log reason | Text | No | Reason shown in the audit log. Maximum length: 512 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Server | Server | The updated server. |
Set default notifications
Configure whether members get notified for all messages or only mentions by default.
Required permissions: Manage server.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Notifications level | Default notifications | Yes | The new default notification level. |
| Audit log reason | Text | No | Reason shown in the audit log. Maximum length: 512 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Server | Server | The updated server. |
Set MFA level
Require two-factor authentication for moderators (server owner only).
Required permissions: Manage server.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| MFA level | Two-factor requirement | Yes | The new MFA requirement. |
| Audit log reason | Text | No | Reason shown in the audit log. Maximum length: 512 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Server | Server | The updated server. |
Set vanity URL
Set or clear the server's vanity invite code (boost level 3 required).
Required permissions: Manage server.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Vanity code | Text | Yes | The new vanity code (2-32 chars), or empty to clear. Length: 2 to 32 characters. |
| Audit log reason | Text | No | Reason shown in the audit log. Maximum length: 512 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Server | Server | The updated server. |
Set preferred locale
Set the server's preferred locale used for system messages.
Required permissions: Manage server.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Locale | Text | Yes | An ISO locale identifier such as en-US. |
| Audit log reason | Text | No | Reason shown in the audit log. Maximum length: 512 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Server | Server | The updated server. |
Transfer server ownership
Transfer ownership of the server to another member. The bot must own the server and have MFA enabled.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| New owner | Server member | Yes | The member who will become the new owner. |
| Audit log reason | Text | No | Reason shown in the audit log. Maximum length: 512 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Server | Server | The updated server. |
Leave server
Remove the bot from a server.
Fetch server preview
Get a public preview of a discoverable server.
Outputs
| Name | Type | Details |
|---|---|---|
| Preview | Server preview | The discoverable server preview. |
Fetch widget settings
Read the server widget enable state and target channel.
Required permissions: Manage server.
Outputs
| Name | Type | Details |
|---|---|---|
| Enabled | Yes/No | Whether the widget is enabled. |
| Channel | Server channel | The channel the widget invite points to. May be empty. |
Update widget settings
Enable or disable the server widget and pick its invite channel.
Required permissions: Manage server.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Enabled | Yes/No | Yes | Whether the widget is enabled. |
| Channel | Server channel | No | The channel the widget invite should point to. |
| Audit log reason | Text | No | Reason shown in the audit log. Maximum length: 512 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Enabled | Yes/No | Whether the widget is now enabled. |
| Channel | Server channel | The new widget invite channel. May be empty. |
Fetch server templates
List all server templates created from a server.
Required permissions: Manage server.
Outputs
| Name | Type | Details |
|---|---|---|
| Templates | List of Server template | All templates of the server. |
Create server template
Snapshot the server's structure into a new template.
Required permissions: Manage server.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Name | Text | Yes | The template name. Length: 1 to 100 characters. |
| Description | Text | No | A short template description. Maximum length: 120 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Template | Server template | The created template. |
Update server template
Edit a template's name and description.
Required permissions: Manage server.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Template | Server template | Yes | The template to update. |
| Name | Text | No | The new name. Length: 1 to 100 characters. |
| Description | Text | No | The new description. Maximum length: 120 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Template | Server template | The updated template. |
Delete server template
Permanently delete a server template.
Required permissions: Manage server.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Template | Server template | Yes | The template to delete. |
Outputs
| Name | Type | Details |
|---|---|---|
| Template | Server template | The deleted template. |
Sync server template
Refresh the template's snapshot from its source server.
Required permissions: Manage server.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Template | Server template | Yes | The template to sync. |
Outputs
| Name | Type | Details |
|---|---|---|
| Template | Server template | The synced template. |
Fetch integrations
List all integrations installed in a server.
Required permissions: Manage server.
Outputs
| Name | Type | Details |
|---|---|---|
| Integrations | List of Server integration | All integrations in the server. |
Delete integration
Remove an integration from a server.
Required permissions: Manage server.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Integration | Server integration | Yes | The integration to remove. |
| Audit log reason | Text | No | Reason shown in the audit log. Maximum length: 512 characters. |
Create soundboard sound
Upload a new soundboard sound to a server.
Required permissions: Manage expressions.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Name | Text | Yes | The sound name (2-32 chars). Length: 2 to 32 characters. |
| Sound file URL | URL | Yes | URL of the audio file (MP3 or OGG; max 512KB, up to 5.2 seconds). |
| Volume | Decimal number | No | Playback volume between 0.0 and 1.0. Value: 0 to 1. Default: 1. |
| Emoji name | Text | No | Unicode emoji shown beside the sound. |
| Audit log reason | Text | No | Reason shown in the audit log. Maximum length: 512 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Sound | Soundboard sound | The created soundboard sound. |
Update soundboard sound
Edit a soundboard sound's name, volume, or emoji.
Required permissions: Manage expressions.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Sound | Soundboard sound | Yes | The sound to update. |
| Name | Text | No | The new sound name. Length: 2 to 32 characters. |
| Volume | Decimal number | No | The new playback volume. Value: 0 to 1. |
| Emoji | Text | No | The new associated emoji. |
| Audit log reason | Text | No | Reason shown in the audit log. Maximum length: 512 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Sound | Soundboard sound | The updated sound. |
Delete soundboard sound
Permanently delete a soundboard sound.
Required permissions: Manage expressions.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Sound | Soundboard sound | Yes | The sound to delete. |
| Audit log reason | Text | No | Reason shown in the audit log. Maximum length: 512 characters. |
Play soundboard sound
Play a soundboard sound in a voice channel the bot has joined.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Voice channel | Voice channel | Yes | The voice channel to play the sound in. |
| Sound | Soundboard sound | Yes | The soundboard sound to play. |
Fetch soundboard sounds
List all soundboard sounds in a server.
Outputs
| Name | Type | Details |
|---|---|---|
| Sounds | List of Soundboard sound | All soundboard sounds in the server. |
Fetch default soundboard sounds
List Discord's default soundboard sounds available everywhere.
Outputs
| Name | Type | Details |
|---|---|---|
| Sounds | List of Soundboard sound | Discord's default soundboard sounds. |
Fetch welcome screen
Loads the welcome screen configuration of a server.
Outputs
| Name | Type | Details |
|---|---|---|
| Welcome Screen | Welcome screen | The fetched welcome screen. |
Update welcome screen
Updates the welcome screen of a server. Requires the MANAGE_GUILD permission.
Required permissions: Manage server.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Enabled | Yes/No | No | Whether the welcome screen should be enabled. |
| Description | Text | No | New welcome-screen description (max 140 characters). Maximum length: 140 characters. |
| Welcome Channels | List of Welcome screen channel | No | Up to five highlighted channels. Maximum items: 5. |
| Audit Log Reason | Text | No | Reason recorded in the audit log (max 512 characters). Maximum length: 512 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Welcome Screen | Welcome screen | The updated welcome screen. |
Fetch server onboarding
Loads the onboarding configuration of a server.
Outputs
| Name | Type | Details |
|---|---|---|
| Onboarding | Server onboarding | The fetched onboarding configuration. |
Update server onboarding
Updates the onboarding configuration of a server. Requires MANAGE_GUILD and MANAGE_ROLES.
Required permissions: Manage server, Manage roles.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Prompts | List of Onboarding prompt | Yes | Onboarding prompts shown to new members. |
| Default Channel IDs | List of Discord ID | Yes | Channels visible to every member by default. |
| Enabled | Yes/No | Yes | Whether onboarding should be enabled. |
| Mode | Onboarding mode | Yes | Whether to count only default channels or also prompt channels toward onboarding constraints. |
| Audit Log Reason | Text | No | Reason recorded in the audit log (max 512 characters). Maximum length: 512 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Onboarding | Server onboarding | The updated onboarding configuration. |
Fetch widget image URL
Returns the URL of the server's widget image in the requested style.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Style | Widget image style | Yes | How the widget image looks. Default: Shield. |
Outputs
| Name | Type | Details |
|---|---|---|
| URL | URL | URL pointing to the rendered widget image. |
Fetch server template by code
Fetches a server template by its public code.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Template code | Text | Yes | Public template code (the part after discord.new/). Length: 1 to 32 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Template | Server template | The fetched template, or empty. May be empty. |
Get server
Reads details of the current server.
Outputs
| Name | Type | Details |
|---|---|---|
| Server | Server | The current server. |