Links

Access Codes

Access codes are codes for keypad devices. These are used when you want to provide access to a lock using a PIN code.

What is an Access Code?

An Access Code is a code used for a keypad or pinpad device. Unlike physical keys, which can be easily lost or duplicated, PIN codes can be customized, tracked, and altered on-the-fly. Using Seam's Access Code API, you can easily generate access codes on the hundreds of door lock models that we integrate with.
Seam supports programming two types of access codes, ongoing and time-bound. To differentiate between the two, refer to the type property of the access code. Ongoing codes display as ongoing, whereas time-bound codes are labeled time_bound.
Ongoing Access Codes: Ideal for residents or long-term users. Ongoing codes remain active on a device until removed. They can start right away or at a later date if you provide a starts_attimestamp.
Timeline of an ongoing access code. The code will remain active until you ask Seam to remove it.
Time Bound: Suitable for temporary access like guest visits or service appointments. These codes operate between a designated starts_at and ends_at time window, granting access only during that period.
Timeline of an time-bound access code. The code will remain active until the ends_at timestamp you provide Seam.

How Seam programs codes onto the lock

Seam ensures access reliability by initiating the programming of access codes onto the lock ahead of its starts_at time. This approach minimizes the risks of delays or disruptions during the programming process.

Native Scheduling

For locks that support setting codes with a schedule, Seam will preload access codes onto the device a full 72 hours before the starts_at timestamp of a Time Bound code. When the starts_at time arrives, the code automatically activates and will remain active until its ends_at time. We enable this "Native scheduling" functionality by default for all providers that support this (see the table below for a list of supported providers). You can choose to override this default behavior, and have Seam perform "Just-in-time scheduling" by setting prefer_native_scheduling to false when creating a code.
72 hours before the starts_at timestamp, Seam inserts the code into the device's internal memory. When the starts_at time arrives, the device automatically activates the code. It is then automatically deactivated at the ends_at timestamp.

Native Scheduling — Supported Providers

✅ Supported
✖️ Not Supported
2N
Hubitat
August
Lockly
Igloohome
Nuki
Kwikset
SmartThings
Salto
Dormakaba Oracode
Schlage
TTLock
Yale

Just-in-time Scheduling

For those locks that lack native scheduling functionality, Seam will use its own scheduling infrastructure to program the code 30 minutes before the starts_at time, and remove it at the ends_at time.
When the starts_at time arrives, Seam adds the code to the device and activates it. It is then automatically deactivated at the ends_at timestamp.

Advanced Feature: Backup Access Codes

Occasionally, Seam may encounter issues when programming codes onto locks. Such hiccups can arise from device connectivity issues, manual interventions from the lock or its accompanying app, or service disruptions from the lock providers. Given these issues, we strongly advise preprogramming a set of backup codes onto the door lock. Should you detect a failure in access code programming, these backup codes can be promptly shared.
Seam offers a Backup Access Code service. When activated, this service automatically maintain a pool of pre-programmed access codes on a device. These codes are programmed in addition to the regular access codes on Seam, acting as a safety net in case of any issues with the primary codes. Please read about how to enable and request a back up code here.
Use our backup code pool service to automatically maintain a set of back up codes on your device.
© Seam Labs, Inc. All rights reserved.