Skip to main content

SmartThings

With SmartThings modules in Make, you can:

  • execute and list rules

  • execute and list scenes

  • create, update, retrieve, list, and delete locations

  • create, update, retrieve, list, and delete rooms

To get started with SmartThings, create an account at smartthings.com.

Connect SmartThings to Make

To connect to SmartThings app, you need to obtain the Personal Access Token.

  1. Log in to your SmartThings account.

  2. Click Generate New Token.

    SmartThings_2.png
  3. Select the Authorized Scopes and click Generate Token.

    SmartThings_5.png
  4. Copy the personal access token to a safe place.

    SmartThings_4.png
  5. Log in to your Make account, insert a SmartThings module in your scenario and click the Add button next to the Connection field.

    SmartThings_1.gif
  6. In the Connection name field, enter a name for the connection.

  7. In the Personal Access Token field, enter the token copied in step 4 and click Save.

You have successfully connected the SmartThings app and can now build scenarios.

Rules

You can execute and list rules using the following modules.

Executes a rule.

Connection

Establish a connection to your SmartThings account.

Location ID

Select or map the Location ID whose rule you want to execute.

Rule ID

Select or map the Rule ID you want to execute.

Lists rules.

Connection

Establish a connection to your SmartThings account.

Location ID

Select or map the Location ID whose rules you want to list.

Limit

Set the maximum number of rules Make will return during one execution cycle.

Scenes

You can execute and list scenes using the following modules.

Executes a scene.

For field descriptions, see the SmartThings API reference.

Lists scenes.

Connection

Establish a connection to your SmartThings account.

Location ID

Select or map the Location ID whose scenes you want to list.

Limit

Set the maximum number of scenes Make will return during one execution cycle.

Locations

You can create, update, retrieve, list, and delete locations using the following modules.

Creates a location for a user.

For field descriptions, see the SmartThings API reference.

Updates a location.

Connection

Establish a connection to your SmartThings account.

Location ID

Select or map the Location ID whose details you want to update.

For field descriptions, see the SmartThings API reference.

Retrieves a location.

Connection

Establish a connection to your SmartThings account.

Location ID

Select or map the Location ID whose details you want to retrieve.

Allowed

Select whether the items in the response may contain the allowed list property.

Lists all locations currently available in a user account.

Connection

Establish a connection to your SmartThings account.

Limit

Set the maximum number of locations Make will return during one execution cycle.

Deletes a location.

Connection

Establish a connection to your SmartThings account.

Location ID

Select or map the Location ID you want to delete.

Rooms

You can create, update, retrieve, list, and delete rooms using the following modules.

Creates a room.

Connection

Establish a connection to your SmartThings account.

Name

Enter the name of the room. For example, Living Room.

Location ID

Select or map the Location ID to which you want to attach this room.

Updates a room.

Connection

Establish a connection to your SmartThings account.

Name

Enter the name of the room. For example, Living Room.

Location ID

Select or map the Location ID whose room you want to update.

Room ID

Select or map the Room ID whose details you want to update.

Retrieve a room.

Connection

Establish a connection to your SmartThings account.

Location ID

Select or map the Location ID whose room details you want to retrieve.

Room ID

Select or map the Room ID whose details you want to retrieve.

LIsts rooms.

Connection

Establish a connection to your SmartThings account.

Location ID

Select or map the Location ID whose rooms you want to list.

Limit

Set the maximum number of rooms Make will return during one execution cycle.

Deletes a room.

Connection

Establish a connection to your SmartThings account.

Location ID

Select or map the Location ID whose room you want to delete.

Room ID

Select or map the Room ID you want to delete.

Other

You can call APIs using the following module.

Make an API Call

Performs an arbitrary authorized call.

For the list of available endpoints, refer to the SmartThings API Documentation.

Connection

Establish a connection to your SmartThings account.

URL

Enter a path relative to https://api.smartthings.com. For example, /v1/locations.

Method

Select the HTTP method you want to use:

GET

to retrieve information for an entry.

POST 

to create a new entry.

PUT 

to update/replace an existing entry.

PATCH 

to make a partial entry update.DELETE - to delete an entry.

Headers

Enter the desired request headers. You don't have to add authorization headers; we already did that for you.

Query String

Enter the request query string.

Body

Enter the body content for your API call.

Example of Use - Get Rooms

The following API call returns all the rooms from your SmartThings account.

URL: /v1/locations/<location_id>/rooms

Method: GET

0eMJdfcsKz.png

Matches of the search can be found in the module's Output under Bundles > Body > items.

In our example, 3 rooms were returned:

msedge_NQuv852eCh.png