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
of UUIDs (Required)
IDs of the devices for which to create the new access codes.
allow_external_modification
attempt_for_offline_device
behavior_when_code_cannot_be_shared
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
Code to be used for access.
ends_at
is_external_modification_allowed
is_offline_access_code
is_one_time_use
max_time_rounding
name
Name of the new access code.
prefer_native_scheduling
preferred_code_length
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
use_backup_access_code_pool
use_offline_access_code
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