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

# Unmanaged Access Codes Events

> Reference for Seam Unmanaged Access Codes webhook events, including event names, JSON payload examples, and the properties your app receives.

## `access_code.unmanaged.converted_to_managed`

An [unmanaged access code](https://www.seam.co/docs/low-level-apis/smart-locks/access-codes/migrating-existing-access-codes.md) was converted successfully to a managed access code.

```json Example webhook payload theme={"dark"}
{
  "access_code_id": "00000000-0000-0000-0000-000000000000",
  "connected_account_custom_metadata": {},
  "connected_account_id": "00000000-0000-0000-0000-000000000000",
  "created_at": "2025-01-01T00:00:00.000Z",
  "device_custom_metadata": {},
  "device_id": "00000000-0000-0000-0000-000000000000",
  "event_description": "An [unmanaged access code](https://www.seam.co/docs/low-level-apis/smart-locks/access-codes/migrating-existing-access-codes) was converted successfully to a managed access code.",
  "event_id": "00000000-0000-0000-0000-000000000000",
  "event_type": "access_code.unmanaged.converted_to_managed",
  "occurred_at": "2025-01-01T00:00:00.000Z",
  "workspace_id": "00000000-0000-0000-0000-000000000000"
}
```

> [accordion] Properties
>
> **access\_code\_id** `String (UUID)`
>
> ID of the affected access code.
>
> **connected\_account\_custom\_metadata** `Object (String, Boolean values)`
>
> Custom metadata of the connected account, present when connected\_account\_id is provided.
>
> **connected\_account\_id** `String (UUID)`
>
> ID of the connected account associated with the affected access code.
>
> **created\_at** `String (ISO 8601)`
>
> Date and time at which the event was created.
>
> **device\_custom\_metadata** `Object (String, Boolean values)`
>
> Custom metadata of the device, present when device\_id is provided.
>
> **device\_id** `String (UUID)`
>
> ID of the device associated with the affected access code.
>
> **event\_description** `String`
>
> Human-readable description of the event. Persisted when the event is created (so the creating code, including a provider, can supply a tailored description) and otherwise derived from the event.
>
> **event\_id** `String (UUID)`
>
> ID of the event.
>
> **event\_type** `Enum (String)`
>
> Value: `access_code.unmanaged.converted_to_managed`
>
> **occurred\_at** `String (ISO 8601)`
>
> Date and time at which the event occurred.
>
> **workspace\_id** `String (UUID)`
>
> ID of the workspace associated with the event.

## `access_code.unmanaged.failed_to_convert_to_managed`

An [unmanaged access code](https://www.seam.co/docs/low-level-apis/smart-locks/access-codes/migrating-existing-access-codes.md) failed to be converted to a managed access code.

```json Example webhook payload theme={"dark"}
{
  "access_code_errors": [],
  "access_code_id": "00000000-0000-0000-0000-000000000000",
  "access_code_warnings": [],
  "connected_account_custom_metadata": {},
  "connected_account_errors": [],
  "connected_account_id": "00000000-0000-0000-0000-000000000000",
  "connected_account_warnings": [],
  "created_at": "2025-01-01T00:00:00.000Z",
  "device_custom_metadata": {},
  "device_errors": [],
  "device_id": "00000000-0000-0000-0000-000000000000",
  "device_warnings": [],
  "event_description": "An [unmanaged access code](https://www.seam.co/docs/low-level-apis/smart-locks/access-codes/migrating-existing-access-codes) failed to be converted to a managed access code.",
  "event_id": "00000000-0000-0000-0000-000000000000",
  "event_type": "access_code.unmanaged.failed_to_convert_to_managed",
  "occurred_at": "2025-01-01T00:00:00.000Z",
  "workspace_id": "00000000-0000-0000-0000-000000000000"
}
```

> [accordion] Properties
>
> **access\_code\_errors** `Array`
>
> Errors associated with the access code.
>
> **access\_code\_id** `String (UUID)`
>
> ID of the affected access code.
>
> **access\_code\_warnings** `Array`
>
> Warnings associated with the access code.
>
> **connected\_account\_custom\_metadata** `Object (String, Boolean values)`
>
> Custom metadata of the connected account, present when connected\_account\_id is provided.
>
> **connected\_account\_errors** `Array`
>
> Errors associated with the connected account.
>
> **connected\_account\_id** `String (UUID)`
>
> ID of the connected account associated with the affected access code.
>
> **connected\_account\_warnings** `Array`
>
> Warnings associated with the connected account.
>
> **created\_at** `String (ISO 8601)`
>
> Date and time at which the event was created.
>
> **device\_custom\_metadata** `Object (String, Boolean values)`
>
> Custom metadata of the device, present when device\_id is provided.
>
> **device\_errors** `Array`
>
> Errors associated with the device.
>
> **device\_id** `String (UUID)`
>
> ID of the device associated with the affected access code.
>
> **device\_warnings** `Array`
>
> Warnings associated with the device.
>
> **event\_description** `String`
>
> Human-readable description of the event. Persisted when the event is created (so the creating code, including a provider, can supply a tailored description) and otherwise derived from the event.
>
> **event\_id** `String (UUID)`
>
> ID of the event.
>
> **event\_type** `Enum (String)`
>
> Value: `access_code.unmanaged.failed_to_convert_to_managed`
>
> **occurred\_at** `String (ISO 8601)`
>
> Date and time at which the event occurred.
>
> **workspace\_id** `String (UUID)`
>
> ID of the workspace associated with the event.

## `access_code.unmanaged.created`

An [unmanaged access code](https://www.seam.co/docs/low-level-apis/smart-locks/access-codes/migrating-existing-access-codes.md) was created on a device.

```json Example webhook payload theme={"dark"}
{
  "access_code_id": "00000000-0000-0000-0000-000000000000",
  "connected_account_custom_metadata": {},
  "connected_account_id": "00000000-0000-0000-0000-000000000000",
  "created_at": "2025-01-01T00:00:00.000Z",
  "device_custom_metadata": {},
  "device_id": "00000000-0000-0000-0000-000000000000",
  "event_description": "An [unmanaged access code](https://www.seam.co/docs/low-level-apis/smart-locks/access-codes/migrating-existing-access-codes) was created on a device.",
  "event_id": "00000000-0000-0000-0000-000000000000",
  "event_type": "access_code.unmanaged.created",
  "occurred_at": "2025-01-01T00:00:00.000Z",
  "workspace_id": "00000000-0000-0000-0000-000000000000"
}
```

> [accordion] Properties
>
> **access\_code\_id** `String (UUID)`
>
> ID of the affected access code.
>
> **connected\_account\_custom\_metadata** `Object (String, Boolean values)`
>
> Custom metadata of the connected account, present when connected\_account\_id is provided.
>
> **connected\_account\_id** `String (UUID)`
>
> ID of the connected account associated with the affected access code.
>
> **created\_at** `String (ISO 8601)`
>
> Date and time at which the event was created.
>
> **device\_custom\_metadata** `Object (String, Boolean values)`
>
> Custom metadata of the device, present when device\_id is provided.
>
> **device\_id** `String (UUID)`
>
> ID of the device associated with the affected access code.
>
> **event\_description** `String`
>
> Human-readable description of the event. Persisted when the event is created (so the creating code, including a provider, can supply a tailored description) and otherwise derived from the event.
>
> **event\_id** `String (UUID)`
>
> ID of the event.
>
> **event\_type** `Enum (String)`
>
> Value: `access_code.unmanaged.created`
>
> **occurred\_at** `String (ISO 8601)`
>
> Date and time at which the event occurred.
>
> **workspace\_id** `String (UUID)`
>
> ID of the workspace associated with the event.

## `access_code.unmanaged.removed`

An [unmanaged access code](https://www.seam.co/docs/low-level-apis/smart-locks/access-codes/migrating-existing-access-codes.md) was removed from a device.

```json Example webhook payload theme={"dark"}
{
  "access_code_id": "00000000-0000-0000-0000-000000000000",
  "connected_account_custom_metadata": {},
  "connected_account_id": "00000000-0000-0000-0000-000000000000",
  "created_at": "2025-01-01T00:00:00.000Z",
  "device_custom_metadata": {},
  "device_id": "00000000-0000-0000-0000-000000000000",
  "event_description": "An [unmanaged access code](https://www.seam.co/docs/low-level-apis/smart-locks/access-codes/migrating-existing-access-codes) was removed from a device.",
  "event_id": "00000000-0000-0000-0000-000000000000",
  "event_type": "access_code.unmanaged.removed",
  "occurred_at": "2025-01-01T00:00:00.000Z",
  "workspace_id": "00000000-0000-0000-0000-000000000000"
}
```

> [accordion] Properties
>
> **access\_code\_id** `String (UUID)`
>
> ID of the affected access code.
>
> **connected\_account\_custom\_metadata** `Object (String, Boolean values)`
>
> Custom metadata of the connected account, present when connected\_account\_id is provided.
>
> **connected\_account\_id** `String (UUID)`
>
> ID of the connected account associated with the affected access code.
>
> **created\_at** `String (ISO 8601)`
>
> Date and time at which the event was created.
>
> **device\_custom\_metadata** `Object (String, Boolean values)`
>
> Custom metadata of the device, present when device\_id is provided.
>
> **device\_id** `String (UUID)`
>
> ID of the device associated with the affected access code.
>
> **event\_description** `String`
>
> Human-readable description of the event. Persisted when the event is created (so the creating code, including a provider, can supply a tailored description) and otherwise derived from the event.
>
> **event\_id** `String (UUID)`
>
> ID of the event.
>
> **event\_type** `Enum (String)`
>
> Value: `access_code.unmanaged.removed`
>
> **occurred\_at** `String (ISO 8601)`
>
> Date and time at which the event occurred.
>
> **workspace\_id** `String (UUID)`
>
> ID of the workspace associated with the event.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.