API ReferenceTriggers

Get trigger type by slug

Markdown
GET
/api/v3/triggers_types/{slug}

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

Authorization

ApiKeyAuth
x-api-key<token>

API key authentication

In: header

Path Parameters

slug*string

The unique slug identifier for the trigger type. Case-insensitive (internally normalized to uppercase).

Query Parameters

toolkit_versions?null|string|

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

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://backend.composio.dev/api/v3/triggers_types/SLACK_NEW_MESSAGE?toolkit_versions=latest"
{
  "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"
}
{
  "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"
    ]
  }
}