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

URL Fields

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

Query Parameters

Props can be supplied through URL query params: ?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

• 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.

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

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

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

5. Press the Save Changes button.

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
          └──────────────────────────────────────────────────────────────────┘ └────────────────┘
                                          token                                    webhook id