Seam Docs
Search…
🎛
Device Guides
Reference
Legacy System
For Device Manufacturers
Connect Webviews
Use Connect Webview to connect to your users' smart devices with the Seam API
Introduction to Connect Webview
Connect Webview is a component that your users will interact with in order to link their smart devices to Seam and allow you to access their devices via the Seam API.
Seam Connect Webview will handle credential validation, multi-factor authentication, and error handling for each device type that we support.
To allow a user to sign in, you need to create a
connect_webview . After creating the webview, you'll receive a URL that you can use to open an iframe or new window containing a login page for your user.
The Connect Webview Object
connect_webview_iduuid
ID of the Connect Webview
statusstring
pending or authorizedurlstring
URL to the webview
login_successfulboolean
Whether the user logged in successfully using the webview
connected_account_iduuid
ID of the Connected Account that was created after the user successfully logged in
Device Provider Keys
Brand Name
Device Provider Key
Device Features supported
Create a Connect Webview
To allow a user to sign in, you need to create a
connect_webview . After creating the webview, you'll receive a URL that you can use to open an iframe or new window containing a login page for your user. An example of what the webview will look like to your user:
post
https://connect.getseam.com
/connect_webviews/create
Create a connect_webview
You should make a new connect_webview for each unique login request: Each
connect_webview tracks the user that signed in with it, you'll get an error if you re-use a webview for the same user twice, or if you use the same webview for multiple users.Checking a Connect Webview
Unless you're using the
custom_redirect_url you'll probably want to poll your newly created connect_webview to know if the user has signed in, or to get details about what devices they connected.get
https://connect.getseam.com
/connect_webviews/get
Get details of a webview
Python
Javascript
1
seam.connect_webviews.get("123e4567-e89b-12d3-a456-426614174000")
2
3
# ConnectWebview(
4
# connect_webview_id='123e4567-e89b-12d3-a456-426614174000',
5
# status='pending',
6
# url='https://connect.getseam.com/v1/connect_webviews/view?connect_webview_id=123e4567-e89b-12d3-a456-426614174000&auth_token=0000000000000000000000000000',
7
# login_successful=False,
8
# connected_account_id=None
9
# )
Copied!
1
// Coming Soon!
Copied!
List Connect Webviews
get
https://connect.getseam.com
/connect_webviews/list
Fetch list of Connect Webviews
View Connect Webview
get
https://connect.getseam.com
/connect_webviews/view
Render the Connect Webview
Last modified 3mo ago
Copy link