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

# Events

You will notice that events follow a pattern: `resource.event`. Our goal is to provide a consistent system that makes things easier to anticipate and code against.

## Filtering Events

Events can be filtered to only show a single type using the `event_type` query parameter.

<RequestExample>
  ```bash theme={"system"}
  curl --request GET \
    --url https://api.flatpeak.com/events/{id} \
    --header 'Authorization: Bearer <token>'
  ```
</RequestExample>

<ResponseExample>
  ```json theme={"system"}
  {
    "id": "evt_65e42b7827c0526548432b9f",
    "object": "event",
    "time_created": "2022-01-24T14:15:22Z",
    "type": "device.create",
    "data": {
      "id": "dev_63a6087272941ef077a8fd3e",
      "object": "device",
      "live_mode": true,
      "reference_id": "DEV1234567890",
      "time_created": "2022-01-24T14:15:22Z",
      "account_id": "acc_661677911f2197045e6cf1b1",
      "last_seen": "2022-03-22T11:12:21Z"
    }
  }
  ```
</ResponseExample>

## Event Types

This is a list of all the types of events currently available from the [events](/api-reference/anode/events/list-all-events) API endpoint.

We may add more at any time, so you should not assume that only these types exist when developing and maintaining your code.

| Event                      | Description                                                                                                                  |
| :------------------------- | :--------------------------------------------------------------------------------------------------------------------------- |
| `connect_session.complete` | Occurs whenever a Connect session is completed and rates are available. Available in Anode release onwards.                  |
| `customer.create`          | Occurs whenever a customer is created.                                                                                       |
| `customer.delete`          | Occurs whenever a customer is deleted.                                                                                       |
| `customer.update`          | Occurs whenever a customer is updated.                                                                                       |
| `customer.create.failed`   | Occurs when customer creation has failed.                                                                                    |
| `customer.delete.failed`   | Occurs when customer deletion has failed.                                                                                    |
| `customer.update.failed`   | Occurs when customer update has failed.                                                                                      |
| `location.create`          | Occurs whenever a location is created.                                                                                       |
| `location.delete`          | Occurs whenever a location is deleted.                                                                                       |
| `location.update`          | Occurs whenever a location is updated.                                                                                       |
| `location.create.failed`   | Occurs when location creation has failed.                                                                                    |
| `location.delete.failed`   | Occurs when location deletion has failed.                                                                                    |
| `location.update.failed`   | Occurs when location update has failed.                                                                                      |
| `device.create`            | Occurs whenever a device is created.                                                                                         |
| `device.delete`            | Occurs whenever a device is deleted.                                                                                         |
| `device.update`            | Occurs whenever a device is updated.                                                                                         |
| `device.create.failed`     | Occurs when device creation has failed.                                                                                      |
| `device.delete.failed`     | Occurs when device deletion has failed.                                                                                      |
| `device.update.failed`     | Occurs when device update has failed.                                                                                        |
| `schedule.created`         | Occurs when a new schedule is created for a location (beta).                                                                 |
| `tariff.expiring`          | Occurs when a contract term for a tariff element is expiring.                                                                |
| `tariff.expired`           | Occurs when a contract term for a tariff element has expired.                                                                |
| `tariff.fetch.failed`      | Occurs when attempts to sync a tariff element from an upstream data source (such as an energy provider account) have failed. |

## Subscribing to events via Webhooks

You can subscribe to receive a webhook notification when an event occurs in your Flatpeak account. To set up, visit the webhooks section in the [Dashboard](https://dashboard.flatpeak.com) > **Webhooks**.