Guide

Add Trigger - Typescript

Overview

Composio triggers allow your AI agents to respond to events occurring in connected third-party applications in real time. By creating a TypeScript trigger, you define how your agent should listen for and handle specific events—such as a GitHub commit, a new email, or a calendar update—from your integrated app accounts. This workflow walks you through accessing the Composio dashboard and configuring a new TypeScript trigger, enabling event-driven automation for your AI workflows.

Before you begin

  • Active Composio account with valid API key
  • Access to dashboard.composio.dev (ensure you are logged in)
  • At least one connected application account (required to associate with the trigger)

Step by step

1
ClickTriggers

Navigate to the Triggers management section by clicking the 'Triggers' link in the dashboard navigation. This page displays all existing triggers and provides access to trigger creation tools.

Tip. The Triggers link is typically located in the main sidebar or top navigation. If you cannot find it, use your browser's find function (Ctrl+F or Cmd+F) to search for 'Triggers' on the page.
Step 1
2
ClickAdd Trigger

Click the 'Add Trigger' button to open the trigger creation dialog. This action initializes the workflow to configure a new trigger for your agent.

Tip. The 'Add Trigger' button is usually prominently displayed at the top or bottom of the Triggers page. If you see multiple action buttons, look for the one labeled 'Add Trigger' or 'Create Trigger'.
Step 2
3
ClickTypeScript

Select the 'TypeScript' tab in the trigger creation dialog to specify that you want to create a trigger using TypeScript. This allows you to write custom logic in TypeScript to handle the event.

Tip. The creation dialog may offer multiple language or integration options (e.g., Webhook, REST, Python). Ensure you select the 'TypeScript' tab specifically to use Composio's TypeScript SDK for your trigger definition.
Step 3
4
Clickbutton

Click the final action button (typically labeled 'Create', 'Confirm', or 'Save') to complete the trigger creation process. Your new TypeScript trigger is now registered and ready to be configured with event listeners and handler logic.

Tip. Before clicking, verify that all required fields in the form are filled in correctly (e.g., trigger name, event type, connected app account). Some dialogs may show a review screen—take a moment to confirm the details before submission.
Warning. Ensure that you have selected or configured the correct event type and connected account before confirming. Once created, you may need to navigate to the trigger details to add authentication or refine event-handling logic.
Step 4

Confirm it worked

  1. 1The Triggers page loads and displays the trigger management interface
  2. 2The TypeScript tab is selected in the trigger creation modal
  3. 3A new trigger configuration form or code editor appears, ready for input

Common issues

Keep reading