Skip to main content
Configuration > Integrations can connect one Govee Cloud account to each server. Connecting only verifies your key and counts your devices. It does not change your lights. To control lights and trigger scenes from TikTok gifts, use Light Effects after you connect.

Get a Govee Cloud API key

  1. Open the Govee Home mobile app and go to Settings.
  2. Select Apply for API Key.
  3. Fill in your details, describe how you plan to use the API, and submit.
  4. Check your email for Govee’s approval. The email contains your API key.
Govee’s official instructions include screenshots.
The API GUID shown in Govee Desktop is not a Cloud API key and will be rejected. Govee Desktop does not need to be running.
Generating a new key in Govee Home invalidates your previous key. Govee’s free API is limited to non-profit use, so check Govee’s terms for your intended use.

Connect

  1. Open Configuration > Integrations and find Govee Cloud.
  2. Paste your key into Cloud API key.
  3. Select Verify & connect.
BrewBot checks the key with Govee before saving it. The card then shows when the key was last verified and how many devices were found. Zero devices is a valid result; add compatible devices in Govee Home, then select Refresh devices. The key is encrypted for this server and is never shown again. If BrewBot hasn’t been added to the server yet, add the bot first.

Refresh, replace, or disconnect

The device count and verification time reflect the last successful save or refresh. BrewBot does not monitor the connection continuously. Every request BrewBot sends to Govee with your key counts toward a daily budget of 9,999, one under Govee’s limit of 10,000 a day. This includes verifying and refreshing here. See Govee’s daily limit. If a refresh says Govee no longer accepts the saved key, you probably generated a new key in Govee Home. Paste the new key to replace the old one, then turn gift automation back on in Light Effects. If the new key belongs to a different Govee account, gift effects saved for the old account’s lights are flagged in Light Effects. Choose a light and scene again for those gifts.

Who can manage it

Personal server owners, team admins, and designated server admins can connect, refresh, replace, and disconnect Govee. Other members with access to the server can see the connection status but not the key. See Permissions.