Get 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.

/connect_webviews/get

post

Returns a specified Connect Webview.

Unless you're using a custom_redirect_url, you should poll a newly-created connect_webview to find out if the user has signed in or to get details about what devices they've connected.

Authorizations

client_sessionclient_session_with_customerpat_with_workspaceconsole_session_with_workspaceapi_key

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

connect_webview_idstring · uuidRequired

ID of the Connect Webview that you want to get.

Responses

200

OK

application/json

okbooleanRequired

400

Bad Request

401

Unauthorized

post

/connect_webviews/get

HTTPcURLJavaScriptPython

POST /connect_webviews/get HTTP/1.1
Host: connect.getseam.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 61

{
  "connect_webview_id": "123e4567-e89b-12d3-a456-426614174000"
}

{
  "connect_webview": {
    "connect_webview_id": "123e4567-e89b-12d3-a456-426614174000",
    "workspace_id": "123e4567-e89b-12d3-a456-426614174000",
    "created_at": "2026-02-21T02:46:56.328Z",
    "connected_account_id": "123e4567-e89b-12d3-a456-426614174000",
    "url": "https://example.com",
    "device_selection_mode": "none",
    "accepted_providers": [
      "text"
    ],
    "accepted_capabilities": [
      "lock"
    ],
    "any_provider_allowed": true,
    "login_successful": true,
    "status": "pending",
    "custom_redirect_url": "https://example.com",
    "custom_redirect_failure_url": "https://example.com",
    "custom_metadata": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "automatically_manage_new_devices": true,
    "wait_for_device_creation": true,
    "authorized_at": "2026-02-21T02:46:56.328Z",
    "selected_provider": "text",
    "customer_key": "text"
  },
  "ok": true
}

Code Example

Python

seam.connect_webviews.get("123e4567-e89b-12d3-a456-426614174000")

# ConnectWebview(
#   connect_webview_id='d8e981cb-5f67-461f-9ab8-f7716e8aef4a',
#   status='authorized',
#   url='https://connect.getseam.com/connect_webviews/view?connect_webview_id=d8e981cb-5f67-461f-9ab8-f7716e8aef4a&auth_token=L9ASMhP19fTbuWbsTLjWdGLUsT1UAVqLX',
#   login_successful=True, 
#   connected_account_id='137db755-0b63-47d6-a2de-3ff673a77e5a'
# )

Javascript

Ruby

PHP

Parameters

connected_account_id	type: string Optional	ID of the Connected Account
email	type: string Optional	Email address used to create account

Response

This section shows the JSON response returned by the API. Since each language encapsulates this response inside objects specific to that language and/or implementation, the actual type in your language might differ from what’s written here.

JSON format

JSON

{
    "connect_webview": {
    	"connect_webview_id": "123e4567-e89b-12d3-a456-426614174000",
	"custom_redirect_url": null,
	"url": "https://connect.getseam.com/v1/connect_webviews/view?connect_webview_id=02454094-1cab-4693-babc-afa9e1c55f09&auth_token=P7XLD4hYXva24WqwSKTC4pKQMP7v3zWUz",
	"workspace_id": "84dda4b8-f327-4d97-a720-e0504a13a441",
	"device_selection_mode": "none",
	"accepted_providers": [
		"smartthings"
	],
	"selected_provider": "smartthings",
	"accepted_devices": [],
	"any_provider_allowed": false,
	"any_device_allowed": null,
	"created_at": "2022-02-07T18:33:50.271Z",
	"login_successful": false,
	"status": "pending"
    }
}