API ReferenceTriggers

List trigger types

Markdown
GET/api/v3/triggers_types

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

Authorization

ApiKeyAuth
x-api-key<token>

API key authentication

In: header

Query Parameters

toolkit_slugsnullable array

Array of toolkit slugs to filter triggers by

toolkit_versionsnull | string | object

Toolkit version specification. Use "latest" for latest versions or bracket notation for specific versions per toolkit.

limitnullable number

Number of items per page, max allowed is 1000

cursorstring

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.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://backend.composio.dev/api/v3/triggers_types?toolkit_versions=latest"
{
  "items": [
    {
      "slug": "SLACK_NEW_MESSAGE",
      "name": "New Message in Slack Channel",
      "description": "Triggers when a new message is posted to a Slack channel",
      "instructions": "string",
      "type": "webhook",
      "toolkit": {
        "slug": "slack",
        "name": "Slack",
        "logo": "https://example.com/logo.png"
      },
      "config": {
        "channel_id": {
          "type": "string",
          "required": true
        },
        "message_type": {
          "type": "enum",
          "options": [
            "all",
            "direct",
            "channel"
          ]
        }
      },
      "payload": {
        "message": {
          "type": "string"
        },
        "sender": {
          "type": "object",
          "properties": {
            "id": "string",
            "name": "string"
          }
        },
        "timestamp": {
          "type": "number"
        }
      },
      "version": "20250930_00"
    }
  ],
  "next_cursor": "string",
  "total_pages": 0,
  "current_page": 0,
  "total_items": 0
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}