Integrations/SwitchBot

Seam × SwitchBot

Seam connects 4 SwitchBot smartlock models to your app. Grant access, control devices and read state through one API, with capability flags that tell your app what each model can do.

Create your first access code - free

Build it with your AI agent

Read the API docs

Supported models: 4
Device type: 1
Connected system: 1

Quickstart

Create an access code in 60 seconds

One Access Grant issues the code on a connected SwitchBot lock. Seam generates the PIN, programs the device, and removes it when the window closes.

1# A three-day window starting now, so a copied snippet is never a dead grant.
2STARTS_AT=$(date -u +%Y-%m-%dT%H:%M:%SZ)
3ENDS_AT=$(date -u -v+3d +%Y-%m-%dT%H:%M:%SZ 2>/dev/null || date -u -d '+3 days' +%Y-%m-%dT%H:%M:%SZ)
4
5curl -X POST 'https://connect.getseam.com/access_grants/create' \
6  -H "Authorization: Bearer ${SEAM_API_KEY}" \
7  -H 'Content-Type: application/json' \
8  -d '{
9    "user_identity": {
10      "full_name": "Jane Doe",
11      "email_address": "jane@example.com"
12    },
13    "device_ids": ["6ba7b811-9dad-11d1-80b4-00c04fd430c8"],
14    "requested_access_methods": [{ "mode": "code" }],
15    "starts_at": "'"$STARTS_AT"'",
16    "ends_at": "'"$ENDS_AT"'"
17  }'

Fastest path

Build it with your AI agent

Install the Seam plugin and your coding agent picks up three integration skills: Reservation Automations, Access Grants and Access Codes. It then writes the calls the way we would. Paste the prompt below and let it build.

1. Install the plugin

/plugin marketplace add seamapi/seam-plugin
/plugin install seam@seamapi

The Claude Code install also adds our documentation MCP server, so the agent can look up endpoints and device capabilities while it works. Cursor, Codex and other agents get the skills through npx skills add and can add the MCP server there separately.

2. Paste this prompt

Prompt

Using the Seam Access Grants skill, integrate SwitchBot devices into my app. In a sandbox workspace: connect a virtual SwitchBot device, read its capability flags, create an access grant with requested_access_methods [{ mode: "code" }] for a three-day window, then read the code back once is_issued is true. Explain what Seam did on the device at each step.

View the plugin on GitHub

Use cases

What you can build

Online Access Codes
1 SwitchBot model supports online access codes through Seam.
Remote Unlock
1 SwitchBot model supports remote unlock through Seam.
Remote Lock
1 SwitchBot model supports remote lock through Seam.

FAQ

Frequently asked questions

Which SwitchBot devices work with Seam?

4 SwitchBot models are in Seam's device database today, covering smartlocks. The catalog page lists every model with its live integration status and any hardware requirements.

How do I connect SwitchBot devices to my app?

Your user links their SwitchBot account through Seam Connect Webview: one embedded login flow, no SwitchBot-specific code. Every device behind the account comes back with capability flags your app can read before offering an action.

Which credentials can Seam issue on SwitchBot devices?

online access codes today, through one /access_grants/create call. Support is per model, so check the capability flags on the specific device before offering a credential in your UI.

Do I need a SwitchBot developer account or API keys?

No. Your user signs in with their own SwitchBot account through the Connect Webview, and your app talks only to Seam. You never handle SwitchBot credentials or maintain their API.

How do I test without hardware?

Sandbox workspaces come with virtual SwitchBot devices that behave like the real ones, so you can run the whole flow before anything is installed.

Keep reading

Seam × SwitchBot

Create an access code in 60 seconds

Build it with your AI agent

1. Install the plugin

2. Paste this prompt

What you can build

Online Access Codes

Remote Unlock

Remote Lock

Frequently asked questions

Which SwitchBot devices work with Seam?

How do I connect SwitchBot devices to my app?

Which credentials can Seam issue on SwitchBot devices?

Do I need a SwitchBot developer account or API keys?

How do I test without hardware?

Related