Developer Workspace

Create an Automation

This article explains how to integrate an Automation with SmartThings Cloud on Developer Workspace.

Automations allow a user to control their SmartThings ecosystem without manual intervention.

Go to Developer Workspace

In the Developer Workspace, go to Develop > Automations. Then click on the + CREATE A NEW AUTOMATION if this is your first Automation. Otherwise, click on + NEW to add another Automation.

Set your Automation information

  1. Enter Automation information. Set Automation information

    • Display name - This name represents your Automation on the SmartThings app.
    • Automation name - Provide a unique name for this Automation. Deleting the Automation will also remove this Automation name from SmartThings Cloud.
    • Description – Describe your SmartApp in up to 250 characters.
    • SmartApp instances – Select Single or Multiple to indicate whether you want users to install your solution in one location (Single) or in multiple locations (Multiple). For example, users may have multiple external cloud accounts that need to communicate with SmartThings Cloud.
    • Hosting type – Select WebHook endpoint or AWS Lambda.
      • If you plan to host and execute your SmartApp on your own platform, select WebHook endpoint. Enter the Target URL with the prefix https://. A target URL is used by a server to interpret a JSON payload and run custom logic when an event happens.
      • If you plan to develop a SmartApp as an AWS Lambda function, select AWS Lambda. Enter the Target ARN with the prefix arn:aws:. Amazon Resource Names (ARNs) uniquely identify AWS resources. We require an ARN when you need to specify a resource unambiguously across all of AWS (e.g. in IAM policies, Amazon Relational Database Service [Amazon RDS] tags, and API calls).
    • Scopes – Define OAuth scopes for your SmartApp to allow the third-party cloud to communicate with SmartThings Cloud. See OAuth2 scopes.
    • App settings - All keys and values must be no longer than 1000 characters. Keys must not be duplicated.
  2. Click SAVE.


Self-publishing allows you to test your SmartApp with the SmartThings app.

  1. You can see Client ID and Client secret and also save them by clicking Download .csv file. If your Automation makes requests outside of being called by SmartThings, this information is needed when using a refresh token to receive a new token.
  2. Click SELF-PUBLISH to self-publish your Automation. The Automation information is sent to SmartThings Cloud.

After you self-publish your Automation, you can see your Automation in the list view. And you can copy your Client ID and regenerate Client secret in the Self-publish box.

Next steps