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

# Encoder Events

> Webhook events that Seam emits for the Encoder resource, with example payloads and properties.

## `acs_encoder.added`

An [access system encoder](/low-level-apis/access-systems/working-with-card-encoders-and-scanners) was added.

<ResponseExample>
  ```json Example webhook payload theme={null}
  {
    "acs_encoder_id": "00000000-0000-0000-0000-000000000000",
    "acs_system_id": "00000000-0000-0000-0000-000000000000",
    "connected_account_id": "00000000-0000-0000-0000-000000000000",
    "created_at": "2025-01-01T00:00:00.000Z",
    "event_description": "An [access system encoder](/low-level-apis/access-systems/working-with-card-encoders-and-scanners) was added.",
    "event_id": "00000000-0000-0000-0000-000000000000",
    "event_type": "acs_encoder.added",
    "occurred_at": "2025-01-01T00:00:00.000Z",
    "workspace_id": "00000000-0000-0000-0000-000000000000"
  }
  ```
</ResponseExample>

<Accordion title="Properties">
  <ResponseField name="acs_encoder_id" type="String (UUID)">
    ID of the affected encoder.
  </ResponseField>

  <ResponseField name="acs_system_id" type="String (UUID)">
    ID of the access system.
  </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 event was created.
  </ResponseField>

  <ResponseField name="event_description" type="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.
  </ResponseField>

  <ResponseField name="event_id" type="String (UUID)">
    ID of the event.
  </ResponseField>

  <ResponseField name="event_type" type="Enum (String)">
    Value: `acs_encoder.added`
  </ResponseField>

  <ResponseField name="occurred_at" type="String (ISO 8601)">
    Date and time at which the event occurred.
  </ResponseField>

  <ResponseField name="workspace_id" type="String (UUID)">
    ID of the workspace associated with the event.
  </ResponseField>
</Accordion>

## `acs_encoder.removed`

An [access system encoder](/low-level-apis/access-systems/working-with-card-encoders-and-scanners) was removed.

<ResponseExample>
  ```json Example webhook payload theme={null}
  {
    "acs_encoder_id": "00000000-0000-0000-0000-000000000000",
    "acs_system_id": "00000000-0000-0000-0000-000000000000",
    "connected_account_id": "00000000-0000-0000-0000-000000000000",
    "created_at": "2025-01-01T00:00:00.000Z",
    "event_description": "An [access system encoder](/low-level-apis/access-systems/working-with-card-encoders-and-scanners) was removed.",
    "event_id": "00000000-0000-0000-0000-000000000000",
    "event_type": "acs_encoder.removed",
    "occurred_at": "2025-01-01T00:00:00.000Z",
    "workspace_id": "00000000-0000-0000-0000-000000000000"
  }
  ```
</ResponseExample>

<Accordion title="Properties">
  <ResponseField name="acs_encoder_id" type="String (UUID)">
    ID of the affected encoder.
  </ResponseField>

  <ResponseField name="acs_system_id" type="String (UUID)">
    ID of the access system.
  </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 event was created.
  </ResponseField>

  <ResponseField name="event_description" type="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.
  </ResponseField>

  <ResponseField name="event_id" type="String (UUID)">
    ID of the event.
  </ResponseField>

  <ResponseField name="event_type" type="Enum (String)">
    Value: `acs_encoder.removed`
  </ResponseField>

  <ResponseField name="occurred_at" type="String (ISO 8601)">
    Date and time at which the event occurred.
  </ResponseField>

  <ResponseField name="workspace_id" type="String (UUID)">
    ID of the workspace associated with the event.
  </ResponseField>
</Accordion>
