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

# Get trigger type by slug

> Retrieve detailed information about a specific trigger type using its slug identifier



## OpenAPI

````yaml api-reference/openapi.json GET /api/v3.1/triggers_types/{slug}
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/triggers_types/{slug}:
    get:
      tags:
        - Triggers
      summary: Get trigger type by slug
      description: >-
        Retrieve detailed information about a specific trigger type using its
        slug identifier
      operationId: getTriggersTypesBySlug
      parameters:
        - schema:
            type: string
            description: >-
              The unique slug identifier for the trigger type. Case-insensitive
              (internally normalized to uppercase).
            example: SLACK_CHANNEL_MESSAGE_RECEIVED
          required: true
          description: >-
            The unique slug identifier for the trigger type. Case-insensitive
            (internally normalized to uppercase).
          name: slug
          in: path
        - schema:
            oneOf:
              - type: 'null'
              - type: string
              - type: object
                additionalProperties:
                  type: string
                description: Object representation of parsed bracket notation
          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
      responses:
        '200':
          description: Successfully retrieved trigger type
          content:
            application/json:
              schema:
                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
        '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

````