Skip to content

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

2.0 KB
Raw Blame

Triggers Example

This example demonstrates how to use Composio SDK for triggers.

Setup

  1. Install dependencies:

    pnpm install
    
  2. Configure environment:

    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 verifyWebhook API
  • 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

Support