Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
Triggers Example
This example demonstrates how to use Composio SDK for triggers.
Setup
Install dependencies:
bash pnpm installConfigure environment:
bash cp .env.example .env
Then edit .env and add your API keys:
- COMPOSIO_API_KEY: Get it from Composio Dashboard
- COMPOSIO_WEBHOOK_SECRET: Get it from your webhook configuration in Composio Dashboard
Running the Examples
Trigger Subscription (WebSocket)
# Run the subscription example
pnpm start
# Run in development mode (with file watching)
pnpm dev
Webhook Server (HTTP)
# Start the webhook verification server
pnpm webhook:server
# Then expose it with telebit (https://telebit.cloud/)
telebit http 3000
What This Example Does
src/index.ts - Trigger Subscription
- Initializes Composio SDK
- Subscribes to triggers via WebSocket
- Receives real-time trigger events
src/webhook-server.ts - Webhook Verification
- Starts a Bun HTTP server on port 3000
- Verifies incoming webhook signatures using the new
verifyWebhookAPI - Supports V1, V2, and V3 webhook payload formats
- Returns normalized trigger events
Webhook Headers
When receiving webhooks, the following headers are used:
- webhook-id: Unique message ID (format: msg_xxx)
- webhook-timestamp: Unix timestamp in seconds
- webhook-signature: Signature in format v1,base64EncodedSignature
Customization
Edit src/index.ts or src/webhook-server.ts to:
- Add specific apps you want to integrate with
- Implement your business logic
- Add error handling and logging
Related Examples
- OpenAI Example - Shows integration with OpenAI
- LangChain Example - Shows integration with LangChain
- More Examples - Browse all available examples