> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brewbot.gg/llms.txt
> Use this file to discover all available pages before exploring further.

# Govee Cloud

> Connect a Govee Cloud account to a server so Light Effects can control your lights.

**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](https://docs.brewbot.gg/features/light-effects.md) 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](https://developer.govee.com/reference/apply-you-govee-api-key) include screenshots.

> [!WARNING]
>
> 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

| Action | What it does |
| - | - |
| **Refresh devices** | Checks the saved key with Govee again and updates the device count. You don't need to re-enter the key. |
| **Verify & replace key** | Verifies a new key and replaces the saved one. If the new key is rejected, the saved key is kept. Saving a key pauses [Light Effects](https://docs.brewbot.gg/features/light-effects.md) gift automation. |
| **Disconnect** | Removes the saved key and all Light Effects gift effects from BrewBot. It does not revoke the key at Govee. |

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](https://docs.brewbot.gg/features/light-effects.md#govees-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](https://docs.brewbot.gg/features/permissions.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.