Skip to main content
GET
Get trigger type by slug

Authorizations

x-api-key
string
header
default:your-project-api-key
required

Your Composio project API key. Create or copy it from the Composio dashboard.

Path Parameters

slug
string
required

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

Example:

"SLACK_CHANNEL_MESSAGE_RECEIVED"

Query Parameters

toolkit_versions

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

Response

Successfully retrieved trigger type

slug
string
required

Unique identifier for the trigger type

Example:

"SLACK_CHANNEL_MESSAGE_RECEIVED"

name
string
required

Human-readable name of the trigger

Example:

"New Message in Slack Channel"

description
string
required

Detailed description of what the trigger does

Example:

"Triggers when a new message is posted to a Slack channel"

instructions
string
required

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

type
enum<string>
required
deprecated

Deprecated: use types. poll for any trigger that polls, even one a webhook wakes; otherwise webhook.

Available options:
webhook,
poll
Example:

"webhook"

types
enum<string>[]
required

The trigger mechanisms this trigger supports, in order of preference: webhook (event-based) before poll (scheduled check).

Minimum array length: 1
Available options:
webhook,
poll
Example:
toolkit
object
required

Information about the toolkit that provides this trigger

config
object
required

Configuration schema required to set up this trigger

Example:
payload
object
required

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

Example:
version
string
required

Version of the trigger type

Example:

"20250930_00"

requires_webhook_endpoint_setup
boolean
default:false

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