Skip to main content

Introduction

Welcome to the SmartThings Enterprise developer guide!

The SmartThings Enterprise platform allows businesses to integrate and extend the SmartThings cloud platform within enterprise environments. SmartThings Enterprise provides enhanced features including Enterprise Accounts, role-based access control (RBAC), robust user management, streamlined permission systems, an API, and more.

In the following sections you will learn how to set up your Enterprise Account, authenticate with the Enterprise API, and leverage advanced features like role-based access control and custom permissions.

Enterprise Accounts

Hierarchy and resource management.

Enterprise API Access

Authentication and implementation.

Enterprise API Overview

Learn about the Enterprise API and how to leverage its features.

Enterprise API Reference

Reference the Enterprise API documentation as you implement Enterprise features.


Ready to Start Integrating?

To start using the SmartThings Enterprise API, send an email to partners@smartthings.com and include Enterprise in the subject line. A SmartThings team member will reach out to help you get started on your integration journey.

Use Cases​

The SmartThings Enterprise API is ideal for building a branded IoT solution experience, or integrating IoT into a broader corporate system by offering:

  • ✅ Large-Scale Device Management: Control and manage thousands of connected devices across multiple locations, users, and regions.

  • ✅ Automated Workflows: Integrate SmartThings devices into custom enterprise workflows, allowing for automated control and monitoring of smart devices.

  • ✅ Custom Applications: Build custom dashboards, apps, and services that leverage SmartThings device and location data to provide enhanced experiences for your organization.

Key Features​

  • 👥 Enterprise Accounts: Group IoT resources and users, enabling streamlined access control and centralized management across those resources.

  • ⚡ Role-Based Access Control (RBAC): Assign roles within your organization to control access to SmartThings resources, including devices, locations, and services.

  • 🔒 Permission System: Fine-grained control over access to resources, allowing administrators to assign permissions at the user, device, or location level.

  • 🔑 Service Accounts: This is the primary authentication method for accessing the API. Service Accounts allow secure, automated access to SmartThings resources without user intervention, supporting server-to-server interactions and background processes.