> ## 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 trigger types

> Retrieve a list of available trigger types with optional filtering by toolkit. Results are paginated and can be filtered by toolkit.



## OpenAPI

````yaml api-reference/openapi-v3.json GET /api/v3/triggers_types
openapi: 3.0.0
info:
  version: 3.0.0
  title: Composio Platform API
  description: >-
    Composio v3 API — legacy endpoints under /api/v3/. Use v3.1 for new
    integrations.
  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: Organization Management
    description: Organization Management API endpoints.
    x-group: Organization Management
  - name: Projects
    description: Projects API endpoints.
    x-group: Projects
paths:
  /api/v3/triggers_types:
    get:
      tags:
        - Triggers
      summary: List trigger types
      description: >-
        Retrieve a list of available trigger types with optional filtering by
        toolkit. Results are paginated and can be filtered by toolkit.
      operationId: getTriggersTypes
      parameters:
        - schema:
            type: array
            nullable: true
            items:
              type: string
            description: Array of toolkit slugs to filter triggers by
            example:
              - slack
              - github
          required: false
          description: Array of toolkit slugs to filter triggers by
          name: toolkit_slugs
          in: query
        - schema:
            oneOf:
              - type: string
              - type: object
                additionalProperties:
                  type: string
                description: Object representation of parsed bracket notation
            nullable: true
          required: false
          description: >-
            Toolkit version specification. Use "latest" for latest versions or
            bracket notation for specific versions per toolkit.
          in: query
          name: toolkit_versions
          examples:
            latest_version:
              summary: Latest version for all toolkits
              value: latest
            bracket_notation:
              summary: Specific versions using bracket notation
              value: >-
                Use:
                toolkit_versions[gmail]=20250930_00&toolkit_versions[slack]=20250929_00
            null_value:
              summary: No version specified (uses latest)
              value: null
        - schema:
            type: number
            nullable: true
          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 triggers
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      type: object
                      properties:
                        slug:
                          type: string
                          description: Unique identifier for the trigger type
                          example: SLACK_CHANNEL_MESSAGE_RECEIVED
                        name:
                          type: string
                          description: Human-readable name of the trigger
                          example: New Message in Slack Channel
                        description:
                          type: string
                          description: Detailed description of what the trigger does
                          example: >-
                            Triggers when a new message is posted to a Slack
                            channel
                        instructions:
                          type: string
                          description: >-
                            Step-by-step instructions on how to set up and use
                            this trigger
                        type:
                          type: string
                          enum:
                            - webhook
                            - poll
                          description: >-
                            Deprecated: use types. poll for any trigger that
                            polls, even one a webhook wakes; otherwise webhook.
                          example: webhook
                          deprecated: true
                        types:
                          type: array
                          items:
                            type: string
                            enum:
                              - webhook
                              - poll
                          minItems: 1
                          description: >-
                            The trigger mechanisms this trigger supports, in
                            order of preference: webhook (event-based) before
                            poll (scheduled check).
                          example:
                            - webhook
                            - poll
                        toolkit:
                          type: object
                          properties:
                            slug:
                              type: string
                              description: Unique identifier for the parent toolkit
                              example: slack
                            name:
                              type: string
                              description: 'Deprecated: Use slug instead'
                              example: Slack
                            logo:
                              type: string
                              description: Logo of the toolkit
                              example: https://example.com/logo.png
                          required:
                            - slug
                            - name
                            - logo
                          description: >-
                            Information about the toolkit that provides this
                            trigger
                        config:
                          type: object
                          additionalProperties: {}
                          description: Configuration schema required to set up this trigger
                          example:
                            channel_id:
                              type: string
                              required: true
                            message_type:
                              type: enum
                              options:
                                - all
                                - direct
                                - channel
                        payload:
                          type: object
                          additionalProperties: {}
                          description: >-
                            Schema of the data payload this trigger will deliver
                            when it fires
                          example:
                            message:
                              type: string
                            sender:
                              type: object
                              properties:
                                id: string
                                name: string
                            timestamp:
                              type: number
                        version:
                          type: string
                          description: Version of the trigger type
                          example: 20250930_00
                        requires_webhook_endpoint_setup:
                          type: boolean
                          default: false
                          description: >-
                            True when the developer must register a
                            Composio-issued webhook URL with the upstream
                            provider (e.g. Slack Event Subscriptions, Notion
                            integration webhooks). See the webhook_endpoint API
                            for the setup.
                          example: false
                      required:
                        - slug
                        - name
                        - description
                        - instructions
                        - type
                        - types
                        - toolkit
                        - config
                        - payload
                        - version
                  next_cursor:
                    type: string
                    nullable: true
                  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'
        '404':
          description: Not found
          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

````