---
title: "List active triggers"
method: GET
path: "/api/v3.1/trigger_instances/active"
tags: ["Triggers"]
---

# List active triggers

`GET /api/v3.1/trigger_instances/active`

Retrieves all active trigger instances for your project. Triggers listen for events from connected accounts (e.g., new emails, Slack messages, GitHub commits) and can invoke webhooks or workflows. Use filters to find triggers for specific users, connected accounts, or trigger types.

## Query parameters

- `user_ids` string[], nullable — Array of user IDs to filter triggers by
- `connected_account_ids` string[], nullable — Array of connected account IDs to filter triggers by
- `auth_config_ids` string[], nullable — Array of auth config IDs to filter triggers by
- `trigger_ids` string[], nullable — Array of trigger IDs to filter triggers by
- `trigger_names` string[], nullable — Array of trigger names to filter triggers by. Case-insensitive (internally normalized to uppercase).
- `connectedAccountIds` string[], nullable
- `authConfigIds` string[], nullable
- `triggerIds` string[], nullable
- `show_disabled` boolean, nullable — When set to true, includes disabled triggers in the response.
- `triggerNames` string[], nullable
- `showDisabled` boolean, nullable — DEPRECATED: Use show_disabled instead
- `deprecatedConnectedAccountUuids` string[], nullable — Array of connected account UUIDs to filter triggers by
- `deprecatedAuthConfigUuids` string[], nullable — Array of auth config UUIDs to filter triggers by
- `limit` number, nullable
- `cursor` string

## Response `200`

Successfully retrieved active trigger instances

- object
  - `items` object[], required
    - `uuid` string — Unique identifier of the trigger instance
    - `id` string, triggerInstanceId, required — Nano ID of the trigger instance
    - `connected_account_id` string, required — ID of the connected account this trigger is associated with
    - `trigger_name` string, required — Name of the trigger
    - `connected_account_uuid` string, required — UUID of the connected account this trigger is associated with
    - `user_id` string, required — ID of the user this trigger is associated with
    - `trigger_data` string — Additional data associated with the trigger instance
    - `version` string, required — Version of the trigger instance
    - `trigger_config` object, required — Configuration for the trigger
    - `state` object, required — DEPRECATED: This field exposes internal state and will be removed in a future version.
    - `updated_at` string, required — ISO 8601 timestamp when the trigger instance was updated
    - `disabled_at` string, nullable, required — ISO 8601 timestamp when the trigger instance was disabled, if applicable
    - `disabledAt` string, nullable, required — DEPRECATED: This parameter will be removed in a future version. Please use disabled_at instead.
    - `connectedAccountId` string, required — DEPRECATED: This parameter will be removed in a future version. Please use connected_account_id instead.
    - `triggerName` string, required — DEPRECATED: This parameter will be removed in a future version. Please use trigger_name instead.
    - `updatedAt` string, required — DEPRECATED: This parameter will be removed in a future version. Please use updated_at instead.
    - `triggerConfig` object, required — DEPRECATED: This parameter will be removed in a future version. Please use trigger_config instead.
    - `deprecated` object — Deprecated fields for the trigger instance
      - `createdAt` string, required — Deprecated created_at for the trigger instance
  - `next_cursor` string, nullable
  - `total_pages` number, required
  - `current_page` number, required
  - `total_items` number, required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `500` — Internal server error

---

[API](https://skmtc.net/composiohq/apis/composio-platform-api-v3-1.md) · [All operations](https://skmtc.net/composiohq/apis/composio-platform-api-v3-1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/composiohq/composio-platform-api-v3-1/versions/4239836857f8/schema)