Action commands are used to tell your Gumball what to do when it receives the webhook. Action commands are set with the action parameter in your webhook URL:

Webhook URL: https://app-gumball.com/request?id=gumball_xxxxxxx&action=track_1

Here are the possible commands:

• track_x → play audio track x
• track_random_x-xx → play random track from x to xx
• volume_x → set volume to x (from 0 to 20)
• sleep_on → put Gumball in sleep mode and disable notifications
• sleep_off → put Gumball in active mode and re-able notifications
• reset_wifi → reset saved wifi credentials
• update_firmware → update to the latest firmware version

track_x

This command asks your Gumball to play a specific audio track_x when the notification is received.

Example: https://app-gumball.com/request?id=gumball_xxxxxxx&action=track_12

This will play 12.mp3 from Gumball’s microSD card.

Tips: By default, the command track_0 is a silent track (0.mp3 on the microSD card). This is handy if you want to have your Gumball turn on with the rotating light only, no sound.