Connected Accounts

External third-party accounts to which your user has authorized Seam to get access

Once your user uses a Connect Webview to authorize Seam to control their devices, Seam registers this authorized account as a "connected account." For example, a connected account might be an August account with a list of door locks.

A connected account has a unique ID and stores the following data about the user and their account:

  • User identifier, such as the username or email address that the user uses to log in to their device account.

  • Account type, for example, schlage.

  • A Boolean automatically_manage_new_devices property to indicate whether Seam should import all new devices for the connected account to make these devices available for use and management by the Seam API. Seam sets the initial value for this property based on a corresponding parameter in the associated Connect Webview. However, you can use the Update Connected Account method to change this value.

  • An set of editable custom metadata, such as your own internal ID for the user. This custom metadata is useful for filtering connected accounts using the List Connected Accounts method. If the associated Connect Webview contains custom metadata, Seam transfers this custom metadata as the initial value for this property. However, you can use the Update Connected Account method to change or add custom metadata for the connected account.

  • The date and time at which Seam created the connected account, that is, when the user completed the Connect Webview to authorize access.

  • Any errors or warnings associated with the connected account

Last updated


Š Seam Labs, Inc. All rights reserved.