Issue a mobile key in 60 seconds
One Access Grant issues the key. Seam provisions the credential on the underlying system and returns a client session for your app plus an Instant Key URL.
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
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
How it works
Connect the lock and confirm support
Your user links their lock or access system account through Seam Connect Webview. Seam returns the doors behind it as devices and entrances. There is no device flag for mobile keys: Seam publishes eight boolean capability flags and this is not one of them. Check the device's capabilities_supported array, or ask for { mode: "mobile_key" } in requested_access_methods and handle what Seam reports back.
Create an Access Grant
Name the person, the doors and the window, then ask for a mobile key in requested_access_methods. Seam works out how to satisfy that on the specific hardware, so the call is the same for a battery deadbolt and a wired reader. Swap acs_entrance_ids for space_ids to cover a group of doors, or device_ids when the door is a standalone lock. The credential's schedule ends at ends_at. Deleting the grant requests removal of its credentials from the connected device or access system.
Hand the mobile key to the phone
List the access methods to get the client_session_token. Pass that token to the mobile SDK; keep your workspace API key on your backend. Every mobile key also carries an instant_key_url, a browser-based key you can text to a guest who will never install an app.
Frequently asked questions
Which smart locks support mobile keys?
Seam supports mobile keys on 91 smart lock models from 5 manufacturers, including Salto, Assa Abloy and Dormakaba. The table on this page comes from Seam's device database, and each model links to its own page with the per-system status and any hardware requirements.
How do I check whether a door can take a mobile key?
The device object has eight boolean capability flags, and can_provision_mobile_keys is not one of them. Read the device's capabilities_supported array, or just ask for { mode: "mobile_key" } on the Access Grant and handle what Seam reports back.
Do my users need to install an app to use a mobile key?
Not always. With your own app, the Seam mobile SDK holds the credential and unlocks over Bluetooth. Without one, text the instant_key_url that comes with every mobile key.
Does a mobile key work when the phone has no signal?
Yes, on systems that provision the credential to the phone. The key unlocks over Bluetooth with both the phone and the lock offline, which is why mobile keys suit stairwells and garages.
Can one person hold a mobile key and a PIN code at the same time?
Yes. Request both modes in one Access Grant, or add an access method to an existing grant later. They share the grant's schedule and doors, so a lost phone is not a lockout.
How is this different from each lock vendor's own mobile SDK?
Vendor SDKs are per brand: a different credential model, provisioning flow and revocation rule each time. Seam issues mobile keys through one Access Grants call and one mobile SDK across every system listed here.
Related
- Implement mobile keysSet up mobile credentials and the application flow that delivers them.
- Smart locks that support online access codesEvery model, with the status of each system that issues online access codes.
- Smart locks that support encoded plastic cardsEvery model, with the status of each system that issues encoded plastic cards.
- Smart locks that support remote unlockEvery model, with the status of each system that supports remote unlock.
- Smart locks that support remote lockEvery model, with the status of each system that supports remote lock.
- Smart locks that support offline access codesEvery model, with the status of each system that issues offline access codes.
- Every device and system Seam supportsSearch the whole device database by brand, device type and capability.
- Access control systemsThe wired systems behind the entrances in these grants: Salto, dormakaba, Brivo, ASSA ABLOY and more.
- Smart lock API overviewHow Seam's smart lock API works, from device connection to access automation.