Govee and Samsung SmartThings has no official integration, however there has been some great work done by uncdubdiver on GitHub. Please do support them for this.

I’ve created this guide and the video guide found on this page in order to assist you in getting this setup in your SmartThings system and using it. I’ve had great success with this already and it works for every Govee device I have so far. I don’t have them all, so there are no guarantee people!

Here’s our video, and below that are the steps and the code you’ll need today:

To break it down for you quickly, you’ll need to do the following:

  1. Grab the code below
  2. Create a text file on your PC/Mac and paste it in.
  3. Save As and call it index.html instead of index.txt (you might need to change the type of file to all files instead of .txt file)
  4. Alternatively, you can go to this URL and download the zip file (tap the green code button on that page):
  5. Open that “text file”, which will now open up in a web browser on your computer (because .html is a webpage file). I used Chrome and it worked perfectly for me.
  6. Use the Govee Home app to request an API key. You’ll find it in the Profile section, then hitting the gear icon top right, and then choosing About Us, and finally Apply For API Key.
  7. Check your email that you used to signup with Govee in their app. You should have an API Key there right away.
  8. Put that API key into the configuration page of your Index.html file. You’ll find the configuration page towards the top of Index.html. Tap on Get Configuration and keep all of that data handy.
  9. Open up and login with your SmartThings/Samsung account
  10. Create a new device handler, choose from code, and place the code from this Custom Device Handler into it:
  11. Create a new device. Each new device you create will be for 1 of your Govee devices.
  12. Once created, choose to edit the preferences. Here you’ll put 3 pieces of information for your newly created device: The API Key (left), the Device ID (middle), the Model Number (right). You will find the Device ID and the Model Number in your set of data that you got from the Index.html file. Remember all that data in the Configuration page? That.
  13. Save that information and enjoy having both the Govee app and the SmartThings app controlling your Govee products

Please note that you’re not going to get control in SmartThings for the scenes or the music modes, nor DIY scenes. This is color, on/off, and dimmer control, but automations will work!

Here’s the code for the Index.html file:

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
		<meta http-equiv="Expires" content="Fri, Jan 01 1900 00:00:00 GMT">
		<meta http-equiv="Pragma" content="no-cache">
		<meta http-equiv="Cache-Control" content="no-cache">
		<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
		<meta http-equiv="Lang" content="en">
		<meta name="author" content="Dean Berman - DB Development">
		<meta http-equiv="Reply-to" content="">
		<meta name="generator" content="PhpED 8.0">
		<meta name="description" content="Govee LED Lights device configuration page">
		<meta name="keywords" content="">
		<meta name="creation-date" content="11/09/2020">
		<meta name="revisit-after" content="15 days">
		<title>Govee LED Lights - Device Configuration</title>
		<!-- Latest available jQuery v3.5.1 -->
		<script src=""></script>
		<!-- Latest compiled and minified CSS -->
		<link rel="stylesheet" href="" integrity="sha384-BVYiiSIFeK1dGmJRAkycuHAHRg32OmUcww7on3RYdg4Va+PmSTsz/K68vbdEjh4u" crossorigin="anonymous">
		<!-- Optional theme -->
		<link rel="stylesheet" href="" integrity="sha384-rHyoN1iRsVXV4nD0JutlnGaslCJuC7uwjduW9SVrLvRYooPp2bWYgmgJQIXwl/Sp" crossorigin="anonymous">
		<!-- Latest compiled and minified JavaScript -->
		<script src="" integrity="sha384-Tc5IQib027qvyjSMfHjOMaLkfuWVxZxUPnCJA7l2mCWNIpG9mGCD8wGNIcPD7Txa" crossorigin="anonymous"></script>
		<script type="text/javascript">
			$(document).ready(function() {
				$('#config-btn').bind('click', function() {
					var apikey = $('#apikey').val();
					if(apikey == '') {
						alert('Missing API Key. Please enter it in and try again.');
						return false;
					$('#config-results').html('Loading, please wait...');
						url: '',
						type: 'GET',
						headers: {
							'Govee-API-Key': apikey
						success: function(data) {
							var resp = '';
							if(data.code != '200' || data.message != 'Success') {
								alert('There was a problem getting your Govee devices. Please confirm your Govee API Key and try again.');
								return false;
							if(( == 0) {
								alert('You have no accessible devices setup within your Govee account at this time.');
								return false;
							resp += '<div class="row"><div class="col-xs-12">&nbsp;</div></div>';
							resp += '<div class="row">';
								resp += '<div class="col-xs-3"><strong>Device Name</strong></div>';
								resp += '<div class="col-xs-2"><strong>Model</strong></div>';
								resp += '<div class="col-xs-7"><strong>Device ID</strong></div>';
								//	Now to loop throught the devices and print accordingly...
								for(var a = 0; a < (; a++) {
									resp += '<div class="col-xs-3">' +[a].deviceName + '</div>';
									resp += '<div class="col-xs-2">' +[a].model + '</div>';
									resp += '<div class="col-xs-7">' +[a].device + '</div>';
							resp += '</div>';
							resp += '<div class="row"><div class="col-xs-12">&nbsp;</div></div>';
							resp += '<div class="row">';
								resp += '<div class="col-xs-12">Please use the list below to populate the Samsung SmartThings Device preferences page (see setup steps for <strong>Device</strong>).</div>';
							resp += '</div>';
						error: function(xhr, ajaxOptions, thrownError) {
							alert('There was an error with your Govee API Key. Please confirm and try again.');
							return false;
		<div class="container" style="padding-top:25px;">
			<h2>Govee LED Lights - Device Configuration</h2>
			<h4>DB Development - Dean Berman</h4>
			<h6>Created/Last Updated: 2020-11-09</h6>
			<br />
			<div class="alert alert-danger">IMPORTANT: This is not sponsered or paid for or supported by Govee, this was generated to help anyone else [other than just myself] to get the amazing WiFi Govee LED Lights into Samsung SmartThings for integration, automation, smart panels, ActionTiles, SharpTools, etc.</div>
			<br />
			<ul class="nav nav-tabs" role="tablist">
				<li role="presentation" class="active"><a href="#home" role="tab" data-toggle="tab">Home</a></li>
				<li role="presentation"><a href="#config" role="tab" data-toggle="tab">Configuration</a></li>
				<li role="presentation"><a href="" target="_blank">GitHub</a></li>
			<div class="tab-content">
				<div id="home" class="tab-pane fade active in">
					<div class="panel panel-default">
						<div class="panel-body">
							The Govee LED Lights SmartThings Device Type Handler was generated to fill a need with accessing the WiFi connected Govee LED Lights.
							<br /><br />
							The Device Type Handler is built to handle any of the existing WiFi connected Govee LED Lights that are accesible through their API.
							<br /><br />
							The following list of model numbers are currently supported:
							<br />
							To get your Govee LED Lights device setup properly within Samsung SmartThings, please follow the steps below.
							<br />
							<h4>Govee API Key</h4>
								<li>Open the Govee Home app on your mobile device.</li>
								<li>In the navigation, go to the <em>user/profile</em> page by clicking on the user icon.</li>
								<li>In the <em>My Profile</em> page, select <em>About Us</em>.</li>
								<li>In the <em>About Us</em> page, select <em>Apply for API Key</em>.</li>
								<li>Fill in the form on the <em>Apply for API Key</em> page to retrieve a unique API key for your Govee user account.</li>
									Click [Submit] to apply.
									<br />
									<em>You will receive an email from Govee soon with your unique API key.</em>
							<h4>Device Type Handler</h4>
									Login to the Samsung SmartThings account management interface:
									<a href="" target="_blank"></a>
								<li>In the <em>SmartThings Groovy IDE</em>, navigate to the <em>My Device Handlers</em> link/page.</li>
								<li>In the <em>Device Handlers</em> page, click the [+ Create New Device Handler] button.</li>
								<li>In the <em>Create New Device Handler</em> page, select the <em>From Code</em> tab.</li>
								<li>From the DB Development Govee LED Strips (DBDEV) GitHub page, copy-and-paste in the code for the Device Type Handler in this form/page.</li>
								<li>Click [Create] to save and continue.</li>
									Login to the Samsung SmartThings account management interface:
									<a href="" target="_blank"></a>
								<li>In the <em>SmartThings Groovy IDE</em>, navigate to the <em>My Devices</em> link/page.</li>
								<li>In the <em>Devices</em> page, click the [+ New Device] button.</li>
									In the <em>Create Device</em> page, setup the following settings:
										<li>Name: <em>Setup your device name accordingly</em></li>
										<li>Label: <em>I usually just use the same Name</em></li>
										<li>Zigbee Id: <em>&lt;leave blank&gt;</em></li>
										<li>Device Network Id: <em>Use something that is only characters and dashes or underscores (something unique)</em></li>
										<li>Type: <em>Select Govee LED Strips (DBDEV) from the dropdown list</em></li>
										<li>Version: <em>Select Self-Published</em></li>
										<li>Location: <em>Select Home (or whatever your location name is)</em></li>
										<li>Hub: <em>Select SmartThings Hub (or whatever your hub name is)</em></li>
										<li>Group: <em>&lt;leave blank&gt;</em></li>
									Once completed, click [Create].
								<li>Once the page reloads, in the left column, for <em>Preferences</em>, click <em>edit</em>.</li>
									In the edit preferences page, 3 form fields will be preset. Set each of these form fields accordingly below:
										<li><strong>Govee API Key - Designated Govee API Key for accessing their system</strong> - this value is given to you by Govee from their app (should be found on the Configuration tab)</li>
										<li><strong>Govee KED Device ID - Device ID for the Govee LED Lights</strong> - can be found on the Configuration tab</li>
										<li><strong>Govee LED Model - Model number of the Govee LED Lights</strong> - can be found on the Configuration tab</li>
								<li>Once completed, click [Save].</li>
				<div id="config" class="tab-pane fade">
					<div class="panel panel-default">
						<div class="panel-body">
							The following form/details below will allow you to confirm your Samsung SmartThings Device preferences accordingly.
							<br /><br />
							<label>Govee API Key:</label> <input type="text" name="apikey" id="apikey" class="form-control">
							<small><em>Designated Govee API Key for accessing their system</em></small>
							<br /><br />
							<button name="config-btn" id="config-btn" class="btn btn-sm btn-info">Get Configuration</button>
							<div id="config-results"></div>