API Reference

🔑 Applying for an API Key

What is an API Key?

An API key is a code that is passed in by a computer program to an API (Application Programming Interface) to identify the calling program and to provide access to the resources associated with the API. API keys are used to track and control how the API is being used, for example to prevent malicious use or abuse of the API. They can also be used to authenticate the calling program and to provide usage and billing information. An API key is a secret token that is passed in the header of the API request. It can be a unique string of letters and numbers, or a more complex token, depending on the API and the level of security required.

The Govee Developer API Key is used for authentication, so let’s now learn how to apply for your very own Govee Developer API Key.

Applying for the Govee Developer API Key

  1. Download the Govee Home App:
    1. Download for iOS
    2. Download for Android
  2. Navigate to the My Profile page by clicking on the 👤 icon
  3. Click on the ⚙️ icon on the top right corner to get to Settings
  4. Click on Apply for API Key
  1. Fill in the required fields for Name and Reason for application
    1. Possible reasons include home automation, 3rd party integration, education & research. etc.
  2. Read the Govee Developer API Terms of Service, then click the checkbox to accept

🚧

One Key per Account is Allowed

Govee only allows each user to have one valid API Key at a time. Each time you apply for a key, your last key is deleted and will no longer work.

Please be sure you update your API Key in any integrations to avoid service disruption.

  1. Click Submit

Once you click Submit, you will see the below message. You can check the email account that matches the email address used for your Govee account. Govee will send you a new Govee Developer API Key in an email with additional information.

Requesting a New API Key

Please note that Govee only supports one API Key per user tied to your Gove Home account. The API Keys are sent to your registered email. Keep this API Key safe. If you suspect your API Key is compromised, apply for a new API Key, and a new API Key will be emailed to you, and your previous key will be deleted.