Guide

Add Trigger - Python

Overview

Composio is an integration platform that manages authentication, toolkits, and event-driven workflows across 1000+ applications. Triggers are a core feature that allow you to watch for specific events (like `GITHUB_COMMIT_EVENT`) on a user's connected account and automatically send those events (payloads) to your application. This workflow walks you through the process of creating a new Python-based trigger on the Composio dashboard so your agents and applications can react to real-time events from integrated services.

Before you begin

  • You have a Composio account and are logged into dashboard.composio.dev
  • You have already connected at least one app/service account (e.g., GitHub, Slack) that supports triggers
  • The connected account has the necessary OAuth scopes and permissions required by the trigger you plan to create
  • You know which event type you want to trigger on (e.g., `GITHUB_COMMIT_EVENT`)

Step by step

1
ClickTriggers

Navigate to the Triggers section of the Composio dashboard by clicking the Triggers link in the navigation menu. This section displays all your active triggers and provides access to trigger management tools.

Tip. Triggers appear in the main navigation menu on the left sidebar or top navigation of the dashboard, depending on your dashboard layout.
Step 1
2
ClickAdd Trigger

Initiate the trigger creation process by clicking the Add Trigger button. This opens the form or wizard where you can configure a new trigger for Python.

Tip. The Add Trigger button is typically located in the top-right area of the Triggers page or next to the triggers list.
Step 2
3
Clickbutton

Complete the trigger configuration by clicking the final button (often labeled 'Create', 'Save', or 'Confirm') to finalize the Python trigger. This submits your trigger settings and activates the trigger on your connected account.

Tip. Review all trigger settings (event type, connected account, webhook endpoint if applicable) before clicking the final confirmation button to ensure they match your intended workflow.
Warning. Once created, the trigger will immediately begin watching for events on the connected account. Ensure your webhook endpoint is ready to receive payloads if you are using webhook delivery.
Step 3

Confirm it worked

  1. 1The trigger creation form or confirmation screen appears after clicking the final button, showing the trigger has been added to your dashboard
  2. 2The new trigger is listed in the active triggers section under the Triggers menu
  3. 3The trigger status shows as 'Active' and is associated with the correct connected account

Common issues

Keep reading