---
title: "List subscribable events"
method: GET
path: "/events"
tags: ["Events"]
---

# List subscribable events

`GET /events`

## Request

- Base URL: `https://api.crevio.co/v1`
- URL: `https://api.crevio.co/v1/events`
- Auth: API key in header `Authorization`

Returns every event that an AiTask can subscribe to via `trigger_type: "event"` + `event_conditions.event_type`. Splits results into `internal` (always-on Crevio-emitted events like form_submission.created, order.paid) and `external` (this account's deployed event sources, e.g. `external.gmail.new_email`). The two task events, `task_run.completed` and `task_run.failed`, list `required_conditions: ["after_task_id"]`: a task subscribes to them only by naming the task it runs after.

## Response `200`

Subscribable events

- object
  - `internal` object[]
    - `event_type` string
    - `description` string
    - `source` 'internal'
    - `required_conditions` string[]: Keys `event_conditions` must also carry to subscribe to this event. Absent when `event_type` alone is enough.
  - `external` object[]
    - `event_type` string
    - `event_source_id` string
    - `vendor` string
    - `vendor_component_id` string
    - `configured_props` object
    - `source` 'external'

## Other responses

- `400`: Bad request
- `401`: Authentication required
- `403`: Forbidden
- `429`: Rate limit exceeded — 600 requests per minute per credential. Retry after the number of seconds in `Retry-After`.
- `500`: Internal server error

---

[API](https://skmtc.dev/crevio/apis/crevio-api-v1.md) · [All operations](https://skmtc.dev/crevio/apis/crevio-api-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/crevio/apis/crevio-api-v1/revisions/2219f18ad651?raw)