Create Multiple Linked Access Codes
Last updated
Was this helpful?
Last updated
Was this helpful?
Creates new that share a common code across multiple devices.
Users with more than one door lock in a property may want to create groups of linked access codes, all of which have the same code (PIN). For example, a short-term rental host may want to provide guests the same PIN for both a front door lock and a back door lock.
If you specify a custom code, Seam assigns this custom code to each of the resulting access codes. However, in this case, Seam does not link these access codes together with a common_code_key
. That is, common_code_key
remains null for these access codes.
If you want to change these access codes that are not linked by a common_code_key
, you cannot use /access_codes/update_multiple
. However, you can update each of these access codes individually, using /access_codes/update
.
See also .
device_ids
Array of UUIDs (Required)
IDs of the devices for which you want to create the new access codes.
allow_external_modification
Boolean
attempt_for_offline_device
Boolean
behavior_when_code_cannot_be_shared
String
Desired behavior if any device cannot share a code. If throw
(default), no access codes will be created if any device cannot share a code. If create_random_code
, a random code will be created on devices that cannot share a code.
code
String
Code to be used for access.
ends_at
String
is_external_modification_allowed
Boolean
is_offline_access_code
Boolean
is_one_time_use
Boolean
max_time_rounding
String
name
String
Name of the new access code. Enables administrators and users to identify the access code easily, especially when there are numerous access codes.
prefer_native_scheduling
Boolean
preferred_code_length
Number
Preferred code length. Only applicable if you do not specify a code
. If the affected device does not support the preferred code length, Seam reverts to using the shortest supported code length.
starts_at
String
use_backup_access_code_pool
Boolean
use_offline_access_code
Boolean
Indicates whether of the code is allowed. Default: false
.
Date and time at which the validity of the new access code ends, in format. Must be a time in the future and after starts_at
.
Indicates whether of the code is allowed. Default: false
.
Indicates whether the access code is an .
Indicates whether the is a single-use access code.
Maximum rounding adjustment. To create a daily-bound for devices that support this feature, set this parameter to 1d
.
Indicates whether should be used for time-bound codes when supported by the provider. Default: true
.
Date and time at which the validity of the new access code starts, in format.
Indicates whether to use a provided by Seam. If true
, you can use .
Array of