Issue a key card in 60 seconds
One Access Grant creates the credential. The last step is physical: an encoder writes it to a blank card, or the system attaches it to a card already registered.
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 encoded plastic cards: Seam publishes eight boolean capability flags and this is not one of them. Check the device's capabilities_supported array, or ask for { mode: "card" } 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 key card 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.
Encode or assign the physical card
Send the card access method to an encoder to write a blank card, or let the system attach it to a pre-registered one. is_issued stays false until the credential is on plastic, so read false as your cue to encode. Scan an encoded card later to see which credential it carries and when it expires.
Frequently asked questions
Which smart locks support encoded plastic cards?
Seam supports encoded plastic cards on 91 smart lock models from 4 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 system can encode a card for a door?
Not with a device flag. can_encode_plastic_cards is a device database capability, not one of the eight booleans on the API's device object. Read capabilities_supported, or request { mode: "card" } on the Access Grant and handle what comes back.
Do I need a card encoder at the property?
For systems that write credentials onto blank cards, yes: Seam creates the credential and drives your existing encoder. Other systems assign the credential to a card that is already registered, and no encoder is involved.
Can the same card open several doors?
Yes. Put every entrance on the Access Grant, or pass a space that covers them, and the card is encoded for all of them at once. Adding a door later updates the credential.
What happens to a card when a stay ends?
The credential expires with the grant, so the card stops opening doors at ends_at whether or not it comes back to the desk. Revoking early is a deletion, not a trip to the lock.
Are plastic cards only for hotels?
No, but hotels and offices earn the most from them, because the readers and card stock are already installed. Cards are the cheapest credential to hand someone with no smartphone.
Related
- Implement key cardsIssue a card credential, select an encoder and confirm that encoding completed.
- Smart locks that support online access codesEvery model, with the status of each system that issues online access codes.
- Smart locks that support mobile keysEvery model, with the status of each system that issues mobile keys.
- 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.