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_slugs?|null

Array of toolkit slugs to filter triggers by

toolkit_versions?null|string|

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

limit?number|null

Number of items per page, max allowed is 1000

cursor?string

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"
    ]
  }
}