Integrations/TTLock

Seam × TTLock

Seam connects 52 TTLock 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: 52
Device type: 1
Connected system: 1

Quickstart

Create an access code in 60 seconds

One Access Grant issues the code on a connected TTLock 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 TTLock devices into my app. In a sandbox workspace: connect a virtual TTLock 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
47 TTLock models support online access codes through Seam.
Mobile Keys
11 TTLock models support mobile keys through Seam.
Plastic Card Encoding
14 TTLock models support encoded plastic cards through Seam.
Remote Unlock
47 TTLock models support remote unlock through Seam.
Remote Lock
47 TTLock models support remote lock through Seam.

FAQ

Frequently asked questions

Which TTLock devices work with Seam?

52 TTLock 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 TTLock devices to my app?

Your user links their TTLock account through Seam Connect Webview: one embedded login flow, no TTLock-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 TTLock devices?

online access codes, mobile keys and encoded plastic cards 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 TTLock developer account or API keys?

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

How do I test without hardware?

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

Keep reading

Seam × TTLock

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

Mobile Keys

Plastic Card Encoding

Remote Unlock

Remote Lock

Frequently asked questions

Which TTLock devices work with Seam?

How do I connect TTLock devices to my app?

Which credentials can Seam issue on TTLock devices?

Do I need a TTLock developer account or API keys?

How do I test without hardware?

Related