# Dispatch Webhooks
Dispatch webhooks are a way to get notified when you update your system information on PluralKit. It can be used for integrations where you want to perform some action when you run a bot command on Discord, but also don't want to (or can't) set up a Discord bot to listen to messages.
You will need a publicly-accessible webserver that can receive and process JSON-formatted POST requests.
On the internet, security is important! Don't skip this section.
To get dispatch events from PluralKit, you must set up a public HTTP endpoint. As such, anyone who knows the URL to the endpoint - not only PluralKit - can send POST requests and "pretend" to be PluralKit.
For this reason, when you register a webhook URL, PluralKit generates a secret token, and then includes it with every event sent to you in the
signing_token key. If you receive an event with an invalid
signing_token, you must stop processing the request and respond with a 401 status code.
PluralKit will send invalid requests to your endpoint, with
PING event type, once in a while to confirm that you are correctly validating requests.
# Dispatch Event Model
|the signing token for your webhook URL
|the system ID associated with this event
|the ID of the entity referenced by the event (can be a system/member/group/switch/Discord user ID)
# Dispatch Events
|PluralKit is checking if your webhook URL is working.
|Reply with a 200 status code if the
signing_token is correct, or a 401 status code if it is invalid.
|your system was updated
|system object only containing modififed keys
|your bot settings were updated
|system settings object only containing modified keys
|a new member was created
|member object only containing
|new member ID can be found in the top-level
|a member was updated
|member object only containing modified keys
|member ID can be found in the top-level
|a member was deleted
|old member ID can be found in the top-level
|a new group was created
|group object only containing
|new group ID can be found in the top-level
|a group was updated
|group object only containing modified keys
|group ID can be found in the top-level
|the member list of a group was updated
|This event is currently non-functional
|a group was deleted
|old group ID can be found in the top-level
|a new Discord account was linked to your system
|new account ID can be found in the top-level
|a Discord account was unlinked from your system
|old account ID can be found in the top-level
|your system settings in a specific server were updated
|system guild settings with only modified keys
|the settings for a member in a specific server were updated
|member guild settings with only modified keys
|a message was sent
|a new switch was logged
|a switch was updated
|switch object with only modified keys
|a switch was deleted
|old switch ID can be found in top-level
|your system's switches were bulk deleted
|some information was successfully imported through the
pk;import command to your system