Integrations   ·   User guide   ·   Blog   ·   Sign in   ·   Pre-order
Integrations   ·   User guide   ·   Blog   ·   Sign in   ·   Pre-order

Setting up your Gumball

Step 1: Scan the card

In the box, you’ll find a card with a QR code and your Gumball’s code (it looks like XXXX-XXXX). Scan the QR code with your phone, enter your email (and choose a password if asked): your account is created, with your Gumball already in it.

No QR scanner at hand? Go to app.getgumball.com and type the code under “New Gumball?”.

Creating your Gumball account

Step 2: Plug in and join the Gumball WiFi

Plug your Gumball in an outlet with the power adapter included (12V 1A) and wait about a minute. It opens its own WiFi network, named gumball_xxxxxxx.

On your phone, open your WiFi settings and join that network. A setup page opens by itself.

If it does not, open a web browser and enter the following into the URL bar http://192.168.4.1, which will take you to the same page.

The WiFi step of the guided setup

Step 3: Choose your WiFi

The setup page lists the strongest WiFi networks around. Pick yours, enter its password, and tap “Connect”.

  • Network missing? Tap “Show all networks”, or “Search again”.
  • Hidden network? Choose “Other network…” and type its name exactly.
  • Wrong password? The page tells you, and you can try again.
The Gumball setup page: choose a network, enter its password, Connect

Step 4: You’re online

Your Gumball joins your WiFi and plays its start-up sound (this may take up to 1 min).

Go back to the setup page of your account. It updates by itself and says “Your Gumball is online!”. From there, play a first sound, then create your first webhook.

Review the troubleshooting steps below if you run into any issues.

Your Gumball is online!

🎉 Congrats, your Gumball is ready! Next: connect apps

Troubleshooting

If your Gumball fails to connect to your WiFi, its gumball_xxxxxxx network stays open so you can try again. Keep attention to the following elements:

  • Respect upper / lower case
  • If your WiFi password contains the number 0 or the letter O, do not confound them
  • Make sure the WiFi network you’re trying to connect with is 2.4GHz (not 5GHz)
  • Networks that make you sign in on a web page (hotels, some offices), or that ask for a user name as well as a password, do not work
  • If your Gumball is far from the WiFi router, try to place it closer to your WiFi router
  • The Gumball network closes after 5 minutes without use, then comes back by itself a little later

Changing WiFi later

New router, new password, new office? Just plug your Gumball in. When it cannot find the WiFi it knows, it opens its gumball_xxxxxxx network again and you can redo steps 2 to 4. Your account and your webhooks stay as they are. The “Connect it to WiFi” link on your Gumball’s page shows the steps again.

To move it to another network while the old one is still around, send us a message and we’ll reopen its setup page for you.

Privacy policy · Terms & conditions
Found an issue? Send us a message
© 2026 GetGumball.com