Skip to main content

Supported Platforms

There are nine social notification commands, each with the same subcommands.
  • TikTok - Dispatched whenever a new video is uploaded.
  • Instagram Tier 3 - Dispatched whenever a new post or story is uploaded.
  • YouTube - Dispatched whenever a new video or short is uploaded.
  • Twitter - Dispatched whenever a new tweet is posted by a user.
  • Subreddit - Dispatched whenever a new post is made in a subreddit.
  • SoundCloud - Dispatched whenever an artist releases a song or album.
  • Pinterest - Dispatched whenever a new pin is saved to a board.
  • Twitch & Kick - Dispatched whenever a streamer goes live.

Commands

The following examples use the /social youtube command, but the same syntax applies to the other social notification commands.
Use the /social youtube add subcommand to receive notifications for a specific user.
For YouTube, you can use a channel URL or a username.
Use the /social youtube remove subcommand to no longer receive notifications for a specific user.
For YouTube, the creator parameter will suggest the creators you have added as you type.
Use the /social youtube message subcommand to customize the message content that is displayed when a social notification is dispatched.This command opens a modal where you can customize the message content.
This command is usually used to ping a role or user. In order for the message to actually notify the role or user, you must set the pingable parameter to True.
Use the /social youtube list subcommand to view all users being monitored.

Message Variables

The SoundCloud and YouTube variables that can be used in the message subcommand can be found on the variables page.

Specific Commands

The /social x retweets subcommand allows you to toggle notifications for retweets.
The /social pinterest embeds subcommand allows you to toggle the embed for the notification.

Important Notes

YouTube Channel Incorrect

Sometimes YouTube provides the incorrect channel from the username. This is because the channel isn’t a known result on YouTube. If this happens, you can use the channel URL instead of the username to fix this issue.

Slight Delay in Notifications

Most social notifications are monitored at an interval. This can cause a slight delay in the notification being dispatched, however YouTube and Twitch notifications should be dispatched instantly whenever a new video or stream goes live.

Customizing the Message

You can’t customize the embed for social notifications. However you can customize the message content that is dispatched with the message subcommand. The pinterest command is the only exception, as it has an embeds subcommand which can be used to toggle the embed for the notification.