Get a Connected Account

• Request Parameters

• Response

• Examples

Returns a specified connected account.

JavaScript

Returns a specified connected account, using an ID.

Code:

await seam.connectedAccounts.get({
  connected_account_id: "a289aa54-5488-4707-9a4b-eeea4edf311d",
});

Output:

{
  "account_type": "salto_space",
  "account_type_display_name": "Salto Space",
  "display_name": "j**[email protected]",
  "automatically_manage_new_devices": true,
  "connected_account_id": "a289aa54-5488-4707-9a4b-eeea4edf311d",
  "created_at": "2025-06-15T16:54:17.946329Z",
  "custom_metadata": { "id": "internalId1" },
  "errors": [],
  "user_identifier": {
    "api_url": "https://example.com/api",
    "email": "[email protected]",
    "exclusive": true,
    "phone": "[phone]",
    "username": "jane_doe"
  },
  "warnings": []
}

cURL

Python

Ruby

PHP

Seam CLI

Authentication Methods

• API key

• Client session token

• Personal access token Must also include the seam-workspace header in the request.

To learn more, see Authentication.

Request Parameters

connected_account_id String

ID of the connected account that you want to get.

---

email String

Email address associated with the connected account that you want to get.

---

Response

Returns: connected_account

JSON

{
  "account_type": "salto_space",
  "account_type_display_name": "Salto Space",
  "display_name": "j**[email protected]",
  "automatically_manage_new_devices": true,
  "connected_account_id": "a289aa54-5488-4707-9a4b-eeea4edf311d",
  "created_at": "2025-06-15T16:54:17.946329Z",
  "custom_metadata": { "id": "internalId1" },
  "errors": [],
  "user_identifier": {
    "api_url": "https://example.com/api",
    "email": "[email protected]",
    "exclusive": true,
    "phone": "[phone]",
    "username": "jane_doe"
  },
  "warnings": [],
  "accepted_capabilities": ["lock"]
}

---

Examples

Get a connected account for an email address

Returns a specified connected account, using an email address.

JavaScript

Code:

await seam.connectedAccounts.get({ email: "[email protected]" });

Output:

{
  "account_type": "salto_space",
  "account_type_display_name": "Salto Space",
  "display_name": "j**[email protected]",
  "automatically_manage_new_devices": true,
  "connected_account_id": "a289aa54-5488-4707-9a4b-eeea4edf311d",
  "created_at": "2025-06-15T16:54:17.946329Z",
  "custom_metadata": { "id": "internalId1" },
  "errors": [],
  "user_identifier": {
    "api_url": "https://example.com/api",
    "email": "[email protected]",
    "exclusive": true,
    "phone": "[phone]",
    "username": "jane_doe"
  },
  "warnings": []
}

cURL

Python

Ruby

PHP

Seam CLI