The Instant Key Object

Learn how the instant_key object lets you issue a Bluetooth mobile key with one API call and share it by link, text, or email—no app install required.

The instant_key Object

Represents a Seam Instant Key. For issuing Bluetooth mobile keys, Instant Keys are the fastest way to share access. With a single API call, you can create a mobile key and send it through text or email or embed it in your own app.

There’s no app to install, nor account to create. Your user just taps a link and gets a lightweight, native-feeling experience using iOS App Clip or Instant Apps on Android. Further, Instant Keys work offline, so even in areas with poor cellular or Wi-Fi, like elevator banks or concrete-walled hallways, the Instant Keys still work.

Instant Key

{
  "client_session_id": "bfe3b1c6-fb9e-48b1-9b5b-c762b2983af6",
  "created_at": "2025-06-14T16:54:17.946559Z",
  "expires_at": "2025-06-16T16:54:17.946559Z",
  "instant_key_id": "1d05c2f6-5b6f-4a9c-b80d-1eca26be12b9",
  "instant_key_url": "https://ik.seam.co/ABCXYZ",
  "user_identity_id": "e7a94acb-bd8a-4462-b6fb-8612d35cd7c3",
  "workspace_id": "4d1c24b2-781e-4d1a-8d77-15249ad57c8a"
}

---

Properties

client_session_id · String (UUID)

ID of the client session associated with the Instant Key.

created_at · String (ISO 8601)

Date and time at which the Instant Key was created.

customization · Object

Customization applied to the Instant Key UI.

Show properties

logo_url · String

URL of the logo displayed on the Instant Key.

primary_color · String

Primary color used in the Instant Key UI.

secondary_color · String

Secondary color used in the Instant Key UI.

customization_profile_id · String (UUID)

ID of the customization profile associated with the Instant Key.

expires_at · String (ISO 8601)

Date and time at which the Instant Key expires.

instant_key_id · String (UUID)

ID of the Instant Key.

instant_key_url · String

Shareable URL for the Instant Key. Use the URL to deliver the Instant Key to your user through a link in a text message or email or by embedding it in your web app.

user_identity_id · String (UUID)

ID of the user identity associated with the Instant Key.

workspace_id · String (UUID)

ID of the workspace that contains the Instant Key.