> ## Documentation Index
> Fetch the complete documentation index at: https://docs.seam.co/llms.txt
> Use this file to discover all available pages before exploring further.

# The Connected Account Object

> Learn how the connected_account object represents an external third-party account your user has authorized Seam to access, such as an August account.

## The connected\_account Object

Represents a [connected account](https://docs.seam.co/core-concepts/connected-accounts). A connected account is an external third-party account to which your user has authorized Seam to get access, for example, an August account with a list of door locks.

<ResponseExample>
  ```json Connected Account theme={null}
  {
    "account_type": "salto_space",
    "account_type_display_name": "Salto Space",
    "display_name": "j**n@example.com",
    "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": "jane_doe@example.com",
      "exclusive": true,
      "phone": "+1555551004",
      "username": "jane_doe"
    },
    "warnings": [],
    "accepted_capabilities": [
      "lock"
    ]
  }
  ```
</ResponseExample>

***

## Properties

<ResponseField name="accepted_capabilities" type="Array">
  List of capabilities that were accepted during the account connection process.
</ResponseField>

<ResponseField name="account_type" type="String">
  Type of connected account.
</ResponseField>

<ResponseField name="account_type_display_name" type="String">
  Display name for the connected account type.
</ResponseField>

<ResponseField name="automatically_manage_new_devices" type="Boolean">
  Indicates whether Seam should [import all new devices](https://docs.seam.co/core-concepts/connect-webviews/customizing-connect-webviews#automatically_manage_new_devices) for the connected account to make these devices available for management by the Seam API.
</ResponseField>

<ResponseField name="connected_account_id" type="String (UUID)">
  ID of the connected account.
</ResponseField>

<ResponseField name="created_at" type="String (ISO 8601)">
  Date and time at which the connected account was created.
</ResponseField>

<ResponseField name="custom_metadata" type="object">
  Set of key:value pairs. Adding custom metadata to a resource, such as a [Connect Webview](https://docs.seam.co/core-concepts/connect-webviews/attaching-custom-data-to-the-connect-webview), [connected account](https://docs.seam.co/core-concepts/connected-accounts/adding-custom-metadata-to-a-connected-account), or [device](https://docs.seam.co/core-concepts/devices/adding-custom-metadata-to-a-device), enables you to store custom information, like customer details or internal IDs from your application.
</ResponseField>

<ResponseField name="customer_key" type="String">
  Your unique key for the customer associated with this connected account.
</ResponseField>

<ResponseField name="default_checkin_time" type="String">
  Default reservation check-in time for this connected account, as `HH:mm` (24-hour). Sourced from the connector configuration — set during the connect\_webview for providers like Lodgify whose API does not expose check-in times.
</ResponseField>

<ResponseField name="default_checkout_time" type="String">
  Default reservation check-out time for this connected account, as `HH:mm` (24-hour). Sourced from the connector configuration.
</ResponseField>

<ResponseField name="display_name" type="String">
  Display name for the connected account.
</ResponseField>

<ResponseField name="errors" type="Array">
  Errors associated with the connected account.
</ResponseField>

<ResponseField name="ical_feed_origin" type="String">
  For iCal connected accounts, the platform that produced the feed (for example, `airbnb`, `vrbo`, or `booking`), or `unknown` when it could not be determined. Intended for rendering the source platform's logo.
</ResponseField>

<ResponseField name="ical_url" type="String">
  For iCal connected accounts, the feed URL for the connection. Sourced from the connector configuration.
</ResponseField>

<ResponseField name="image_url" type="String">
  Logo URL for the connected account provider.
</ResponseField>

<ResponseField name="time_zone" type="String">
  IANA time zone (e.g. America/Los\_Angeles) for this connected account. Sourced from the connector configuration.
</ResponseField>

<ResponseField name="user_identifier" type="Object" deprecated>
  User identifier associated with the connected account.

  <Expandable title="properties">
    <ResponseField name="api_url" type="String">
      API URL for the user identifier associated with the connected account.
    </ResponseField>

    <ResponseField name="email" type="String">
      Email address of the user identifier associated with the connected account.
    </ResponseField>

    <ResponseField name="exclusive" type="Boolean">
      Indicates whether the user identifier associated with the connected account is exclusive.
    </ResponseField>

    <ResponseField name="phone" type="String">
      Phone number of the user identifier associated with the connected account.
    </ResponseField>

    <ResponseField name="username" type="String">
      Username of the user identifier associated with the connected account.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="warnings" type="Array">
  Warnings associated with the connected account.
</ResponseField>