Skip to content

Discord

URL Format

Your Discord Webhook-URL will look like this:

https://discord.com/api/webhooks/__webhookid/token__

The shoutrrr service URL should look like this:

discord://token@webhookid[?thread_id=threadid]

Thread Support

To send messages to a specific thread in a Discord channel, include the thread_id query parameter in the service URL with the ID of the target thread. For example:

discord://token@webhookid?thread_id=123456789

You can obtain the thread_id by right-clicking a thread in Discord and selecting "Copy ID" (requires Developer Mode to be enabled in Discord settings).

URL Fields

  • Token (Required)
    URL part: discord://token@webhookid/
  • WebhookID (Required)
    URL part: discord://token@webhookid/

Query/Param Props

Props can be either supplied using the params argument, or through the URL using
?key=value&key=value etc.

  • Avatar - Override the webhook default avatar with specified URL
    Default: empty
    Aliases: avatarurl

  • Color - The color of the left border for plain messages
    Default: 0x50D9ff

  • ColorDebug - The color of the left border for debug messages
    Default: 0x7b00ab

  • ColorError - The color of the left border for error messages
    Default: 0xd60510

  • ColorInfo - The color of the left border for info messages
    Default: 0x2488ff

  • ColorWarn - The color of the left border for warning messages
    Default: 0xffc441

  • JSON - Whether to send the whole message as the JSON payload instead of using it as the 'content' field
    Default: ❌ No

  • SplitLines - Whether to send each line as a separate embedded item
    Default: ✔ Yes

  • ThreadID - The thread ID to send the message to
    Default: empty

  • Title
    Default: empty

  • Username - Override the webhook default username
    Default: empty

Creating a webhook in Discord

  1. Open your channel settings by first clicking on the gear icon next to the name of the channel. Screenshot 1

  2. In the menu on the left, click on Integrations. Screenshot 2

  3. In the menu on the right, click on Create Webhook. Screenshot 3

  4. Set the name, channel, and icon to your liking and click the Copy Webhook URL button. Screenshot 4

  5. Press the Save Changes button. Screenshot 5

  6. Format the service URL:

https://discord.com/api/webhooks/693853386302554172/W3dE2OZz4C13_4z_uHfDOoC7BqTW288s-z1ykqI0iJnY_HjRqMGO8Sc7YDqvf_KVKjhJ
                                 └────────────────┘ └──────────────────────────────────────────────────────────────────┘
                                     webhook id                                    token

discord://W3dE2OZz4C13_4z_uHfDOoC7BqTW288s-z1ykqI0iJnY_HjRqMGO8Sc7YDqvf_KVKjhJ@693853386302554172?thread_id=123456789
          └──────────────────────────────────────────────────────────────────┘ └────────────────┘ └─────────────────┘
                                          token                                    webhook id           thread id