v63

latestOpenAPI 3.0.0Proprietaryraw.githubusercontent.com2026-08-0110571.8 MB

Triggers

Get trigger type by slug

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

get/api/v3.1/triggers_types/{slug}

Path parameters

slugstring required

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

Example:SLACK_CHANNEL_MESSAGE_RECEIVED

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

Query parameters

string

object

Object representation of parsed bracket notation

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

Response

Successfully retrieved trigger type

slugstring required

Unique identifier for the trigger type

namestring required

Human-readable name of the trigger

descriptionstring required

Detailed description of what the trigger does

instructionsstring required

Step-by-step instructions on how to set up and use this trigger

type'webhook' | 'poll' required

The trigger mechanism - either webhook (event-based) or poll (scheduled check)

configobject required

Configuration schema required to set up this trigger

payloadobject required

Schema of the data payload this trigger will deliver when it fires

versionstring required

Version of the trigger type

requires_webhook_endpoint_setupboolean

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 response

{
  "slug": "SLACK_CHANNEL_MESSAGE_RECEIVED",
  "name": "New Message in Slack Channel",
  "description": "Triggers when a new message is posted to a Slack channel",
  "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"
}