> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# List active triggers

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



## OpenAPI

````yaml api-reference/openapi.json GET /api/v3.1/trigger_instances/active
openapi: 3.1.0
info:
  version: 3.1.0
  title: Composio Platform API v3.1
  description: >-
    Composio v3.1 API — all endpoints available under /api/v3.1/. Tool endpoints
    default to the latest tool version.
  contact:
    name: Composio Support
    url: https://composio.dev/support
    email: support@composio.dev
  license:
    name: Proprietary
    url: https://composio.dev/terms
servers:
  - url: https://backend.composio.dev
    description: Composio production API
security:
  - ApiKeyAuth: []
tags:
  - name: Authentication
    description: Authentication related endpoints
    x-group: Authentication
  - name: Auth Configs
    description: Authentication configuration management
    x-group: Auth Configs
  - name: Connected Accounts
    description: Connected account management
    x-group: Connected Accounts
  - name: Logs
    description: Logging and monitoring
    x-group: Logs
  - name: OpenAPI
    description: OpenAPI specification management
    x-group: OpenAPI
  - name: Organization
    description: Organization management
    x-group: Organization
  - name: API Keys
    description: API key management
    x-group: API Keys
  - name: Webhooks
    description: Webhook configuration
    x-group: Webhooks
  - name: Webhook Endpoints
    description: >-
      Per-OAuth-app webhook ingress endpoints. Inbound URLs the provider posts
      to, plus signing secret storage and verification.
    x-group: Webhook Endpoints
  - name: Webhook Subscriptions
    description: >-
      Webhook delivery subscriptions. Outbound URLs Composio posts trigger
      events to, plus signing secret rotation and event-type filters.
    x-group: Webhook Subscriptions
  - name: Team
    description: Team member management
    x-group: Team
  - name: Consumer Skills
    description: Organization-authored Skill management
    x-group: Consumer Skills
  - name: Toolkits
    description: Toolkit and tool management
    x-group: Toolkits
  - name: Tools
    description: Tool execution endpoints
    x-group: Tools
  - name: Triggers
    description: Trigger management and execution
    x-group: Triggers
  - name: Payments
    description: Payment and subscription management
    x-group: Payments
  - name: Billing
    description: Dashboard billing state — usage, subscription, contract (cookie-auth only)
    x-group: Billing
  - name: Compliance
    description: Organization compliance agreements and acceptance state
    x-group: Compliance
  - name: Files
    description: File management
    x-group: Files
  - name: MCP
    description: MCP server management
    x-group: MCP
  - name: MCP Partner
    description: MCP partner management
    x-group: MCP Partner
  - name: Stripe Projects
    description: Stripe Projects provisioning
    x-group: Stripe Projects
  - name: Tool Router
    description: (Labs) Tool router endpoints
    x-group: Sessions (Prev Tool Router)
  - name: Playground
    description: Dashboard playground chat
    x-group: Playground
  - name: Arena
    description: Arena conversations, messages and terms
    x-group: Arena
  - name: Projects
    description: Projects API endpoints.
    x-group: Projects
  - name: Organization Management
    description: Organization Management API endpoints.
    x-group: Organization Management
  - name: Webhook Events
    description: Events delivered by Composio to your registered webhook endpoints
    x-group: Webhook Events
paths:
  /api/v3.1/trigger_instances/active:
    get:
      tags:
        - Triggers
      summary: List active triggers
      description: >-
        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.
      operationId: getTriggerInstancesActive
      parameters:
        - schema:
            type:
              - array
              - 'null'
            items:
              type: string
            description: Array of user IDs to filter triggers by
          required: false
          description: Array of user IDs to filter triggers by
          name: user_ids
          in: query
        - schema:
            type:
              - array
              - 'null'
            items:
              type: string
              format: connectedAccountId
            description: Array of connected account IDs to filter triggers by
          required: false
          description: Array of connected account IDs to filter triggers by
          name: connected_account_ids
          in: query
        - schema:
            type:
              - array
              - 'null'
            items:
              type: string
              format: authConfigId
            description: Array of auth config IDs to filter triggers by
          required: false
          description: Array of auth config IDs to filter triggers by
          name: auth_config_ids
          in: query
        - schema:
            type:
              - array
              - 'null'
            items:
              type: string
              format: triggerInstanceId
            description: Array of trigger IDs to filter triggers by
          required: false
          description: Array of trigger IDs to filter triggers by
          name: trigger_ids
          in: query
        - schema:
            type:
              - array
              - 'null'
            items:
              type: string
            description: >-
              Array of trigger names to filter triggers by. Case-insensitive
              (internally normalized to uppercase).
          required: false
          description: >-
            Array of trigger names to filter triggers by. Case-insensitive
            (internally normalized to uppercase).
          name: trigger_names
          in: query
        - schema:
            type:
              - array
              - 'null'
            items:
              type: string
              format: connectedAccountId
          required: false
          description: >-
            DEPRECATED: This parameter will be removed in a future version.
            Please use connected_account_ids instead.
          deprecated: true
          name: connectedAccountIds
          in: query
        - schema:
            type:
              - array
              - 'null'
            items:
              type: string
              format: authConfigId
          required: false
          description: >-
            DEPRECATED: This parameter will be removed in a future version.
            Please use auth_config_ids instead.
          deprecated: true
          name: authConfigIds
          in: query
        - schema:
            type:
              - array
              - 'null'
            items:
              type: string
              format: triggerInstanceId
          required: false
          description: >-
            DEPRECATED: This parameter will be removed in a future version.
            Please use trigger_ids instead.
          deprecated: true
          name: triggerIds
          in: query
        - schema:
            type:
              - boolean
              - 'null'
            default: false
            description: When set to true, includes disabled triggers in the response.
          required: false
          description: When set to true, includes disabled triggers in the response.
          name: show_disabled
          in: query
        - schema:
            type:
              - array
              - 'null'
            items:
              type: string
          required: false
          description: >-
            DEPRECATED: This parameter will be removed in a future version.
            Please use trigger_names instead.
          deprecated: true
          name: triggerNames
          in: query
        - schema:
            type:
              - boolean
              - 'null'
            default: false
            description: 'DEPRECATED: Use show_disabled instead'
          required: false
          description: >-
            DEPRECATED: This parameter will be removed in a future version.
            Please use show_disabled instead.
          deprecated: true
          name: showDisabled
          in: query
        - schema:
            type:
              - array
              - 'null'
            items:
              type: string
            description: Array of connected account UUIDs to filter triggers by
          required: false
          description: >-
            DEPRECATED: This parameter will be removed in a future version.
            Please use connected_account_ids instead.
          deprecated: true
          name: deprecatedConnectedAccountUuids
          in: query
        - schema:
            type:
              - array
              - 'null'
            items:
              type: string
            description: Array of auth config UUIDs to filter triggers by
          required: false
          description: >-
            DEPRECATED: This parameter will be removed in a future version.
            Please use auth_config_ids instead.
          deprecated: true
          name: deprecatedAuthConfigUuids
          in: query
        - schema:
            type:
              - number
              - 'null'
          required: false
          description: Number of items per page, max allowed is 50
          name: limit
          in: query
        - schema:
            type: string
          required: false
          description: >-
            Cursor for pagination. The cursor is a base64 encoded string of the
            page and limit. The page is the page number and the limit is the
            number of items per page. The cursor is used to paginate through the
            items. The cursor is not required for the first page.
          name: cursor
          in: query
      responses:
        '200':
          description: Successfully retrieved active trigger instances
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      type: object
                      properties:
                        uuid:
                          type: string
                          description: Unique identifier of the trigger instance
                        id:
                          type: string
                          format: triggerInstanceId
                          description: Nano ID of the trigger instance
                        connected_account_id:
                          type: string
                          description: >-
                            ID of the connected account this trigger is
                            associated with
                        trigger_name:
                          type: string
                          description: Name of the trigger
                        connected_account_uuid:
                          type: string
                          description: >-
                            UUID of the connected account this trigger is
                            associated with
                        user_id:
                          type: string
                          description: ID of the user this trigger is associated with
                        trigger_data:
                          type: string
                          description: Additional data associated with the trigger instance
                        version:
                          type: string
                          description: Version of the trigger instance
                        trigger_config:
                          type: object
                          additionalProperties: {}
                          description: Configuration for the trigger
                        type:
                          type: string
                          enum:
                            - webhook
                            - poll
                          description: >-
                            How this trigger instance gets events: webhook (the
                            provider notifies) or poll (a scheduled check).
                          example: webhook
                        fallback_reason:
                          type:
                            - string
                            - 'null'
                          description: >-
                            Set when Composio downgraded to a poll-based
                            mechanism instead of webhooks for this trigger.
                          example: >-
                            No webhook endpoint found for toolkit "gmail".
                            Create a webhook endpoint before setting up
                            triggers.
                        polling_interval:
                          type:
                            - integer
                            - 'null'
                          description: Minutes between scheduled polls for a poll instance.
                          example: 15
                        egress_url:
                          type:
                            - string
                            - 'null'
                          description: >-
                            Delivery URL override for this trigger instance: its
                            events are sent here instead of the project webhook
                            URL, while signing, the payload version and enabled
                            events still come from the project webhook
                            subscription. Null means no override.
                        state:
                          type:
                            - object
                            - 'null'
                          additionalProperties: {}
                          description: >-
                            DEPRECATED: This field exposes internal state and
                            will be removed in a future version.
                          deprecated: true
                        updated_at:
                          type: string
                          description: >-
                            ISO 8601 timestamp when the trigger instance was
                            updated
                        disabled_at:
                          type:
                            - string
                            - 'null'
                          description: >-
                            ISO 8601 timestamp when the trigger instance was
                            disabled, if applicable
                        disabledAt:
                          type:
                            - string
                            - 'null'
                          description: >-
                            DEPRECATED: This parameter will be removed in a
                            future version. Please use disabled_at instead.
                          deprecated: true
                        connectedAccountId:
                          type: string
                          description: >-
                            DEPRECATED: This parameter will be removed in a
                            future version. Please use connected_account_id
                            instead.
                          deprecated: true
                        triggerName:
                          type: string
                          description: >-
                            DEPRECATED: This parameter will be removed in a
                            future version. Please use trigger_name instead.
                          deprecated: true
                        updatedAt:
                          type: string
                          description: >-
                            DEPRECATED: This parameter will be removed in a
                            future version. Please use updated_at instead.
                          deprecated: true
                        triggerConfig:
                          type: object
                          additionalProperties: {}
                          description: >-
                            DEPRECATED: This parameter will be removed in a
                            future version. Please use trigger_config instead.
                          deprecated: true
                        deprecated:
                          type: object
                          properties:
                            createdAt:
                              type: string
                              description: Deprecated created_at for the trigger instance
                          required:
                            - createdAt
                          description: Deprecated fields for the trigger instance
                      required:
                        - id
                        - connected_account_id
                        - trigger_name
                        - connected_account_uuid
                        - user_id
                        - version
                        - trigger_config
                        - type
                        - fallback_reason
                        - polling_interval
                        - egress_url
                        - state
                        - updated_at
                        - disabled_at
                        - disabledAt
                        - connectedAccountId
                        - triggerName
                        - updatedAt
                        - triggerConfig
                  next_cursor:
                    type:
                      - string
                      - 'null'
                  total_pages:
                    type: number
                  current_page:
                    type: number
                  total_items:
                    type: number
                required:
                  - items
                  - total_pages
                  - current_page
                  - total_items
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - ApiKeyAuth: []
        - UserApiKeyAuth: []
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            message:
              type: string
            code:
              type: number
            slug:
              type: string
            status:
              type: number
            request_id:
              type: string
            suggested_fix:
              type: string
            errors:
              type: array
              items:
                type: string
          required:
            - message
            - code
            - slug
            - status
      required:
        - error
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Your Composio project API key. Create or copy it from the Composio
        dashboard.
      x-default: your-project-api-key
    UserApiKeyAuth:
      type: apiKey
      in: header
      name: x-user-api-key
      description: Your Composio user API key for user-scoped endpoints.
      x-default: your-user-api-key

````