Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
TypeScript agentic-aiagentsaiai-agentsaiagentsdeveloper-toolsfunction-callinggpt-4javascriptjsllmllmopsmcppythonremote-mcp-serverssetypescript
navigation high level changes
Sushmithamallesh4fbd95270cbe
diff --git a/fern/docs.yml b/fern/docs.ymlindex 409707196..b854269f0 100644--- a/fern/docs.yml+++ b/fern/docs.yml@@ -90,10 +90,16 @@ redirects:destination: /type-script- source: /sdk-reference/type-script/:pathdestination: /type-script/:path+- source: /docs/tool-router/quick-start+ destination: /tool-router/overviewtabs:docs:display-name: Docsslug: docs+ tool-router:+ display-name: Tool Router+ icon: fa-sparkles+ slug: tool-routerproviders:display-name: Providersskip-slug: true@@ -128,6 +134,24 @@ navigation:- changelog: ./pages/src/changelogtitle: Changelogslug: changelog+ - section: Capabilities+ icon: fa-layer-group+ skip-slug: true+ contents:+ - link: Tool Router+ href: /tool-router/overview+ - page: Managed Authentication+ path: pages/dist/capabilities/managed-authentication.mdx+ slug: managed-authentication+ - page: Tools+ path: pages/dist/capabilities/tools.mdx+ slug: tools+ - page: MCP+ path: pages/dist/capabilities/mcp.mdx+ slug: mcp+ - page: Triggers+ path: pages/dist/capabilities/triggers.mdx+ slug: triggers- section: Tools and Triggersicon: fa-light fa-wrenchskip-slug: true@@ -194,13 +218,6 @@ navigation:- page: Providerspath: pages/dist/mcp/providers.mdxslug: mcp-providers- - section: Tool Router (Beta)- icon: fa-light fa-flask- skip-slug: true- contents:- - page: Quick Start- path: pages/dist/tool-router/quick-start.mdx- slug: tool-router/quick-start- section: Resourcesicon: fa-light fa-bookskip-slug: true@@ -253,6 +270,64 @@ navigation:- page: Triggerspath: pages/dist/resources/troubleshooting/triggers.mdxslug: triggers+- tab: tool-router+ layout:+ - section: Get Started+ icon: fa-light fa-rocket+ skip-slug: true+ contents:+ - page: Overview+ path: pages/dist/tool-router/overview.mdx+ slug: overview+ - page: Quickstart+ path: pages/dist/tool-router/quickstart.mdx+ slug: quickstart+ - section: Core Concepts+ icon: fa-light fa-brain+ skip-slug: true+ contents:+ - page: Understanding Tool Router+ path: pages/dist/tool-router/understanding-tool-router.mdx+ slug: understanding-tool-router+ - page: Sessions+ path: pages/dist/tool-router/sessions.mdx+ slug: sessions+ - page: Meta-Tools+ path: pages/dist/tool-router/meta-tools.mdx+ slug: meta-tools+ - section: Configuration+ icon: fa-light fa-cog+ skip-slug: true+ contents:+ - page: Toolkit Management+ path: pages/dist/tool-router/toolkit-management.mdx+ slug: toolkit-management+ - page: Permissions+ path: pages/dist/tool-router/permissions.mdx+ slug: permissions+ - section: Authentication+ icon: fa-light fa-key+ skip-slug: true+ contents:+ - page: Authentication Flows+ path: pages/dist/tool-router/authentication-flows.mdx+ slug: authentication-flows+ - page: White-Labeling+ path: pages/dist/tool-router/white-labeling.mdx+ slug: white-labeling+ - section: Integration+ icon: fa-light fa-plug+ skip-slug: true+ contents:+ - page: MCP Integration+ path: pages/dist/tool-router/mcp-integration.mdx+ slug: mcp-integration+ - page: Native SDK+ path: pages/dist/tool-router/native-sdk.mdx+ slug: native-sdk+ - page: Framework Examples+ path: pages/dist/tool-router/framework-examples.mdx+ slug: framework-examples- tab: providerslayout:- section: Supported Providers@@ -417,4 +492,4 @@ navigation:contents:- page: Tool Generatorpath: pages/dist/examples/tool-generator/tool-generator.mdx- slug: examples/tool-generator+ slug: examples/tool-generator\ No newline at end of filediff --git a/fern/pages/src/capabilities/managed-authentication.mdx b/fern/pages/src/capabilities/managed-authentication.mdxnew file mode 100644index 000000000..abe88f155--- /dev/null+++ b/fern/pages/src/capabilities/managed-authentication.mdx@@ -0,0 +1,164 @@+---+title: Managed Authentication+image: "https://og.composio.dev/api/og?title=Managed%20Authentication&description=Enterprise-grade%20authentication%20for%20AI%20agents"+subtitle: "Enterprise-grade authentication for AI agents"+description: "Let your AI agents authenticate with 800+ apps on behalf of users. OAuth, API keys, user isolation, and white-labeling built in."+keywords: "managed authentication, ai agent auth, oauth, api keys, user isolation, white-labeling, connected accounts"+hide-nav-links: false+---++~~**Let your AI agents authenticate with 800+ apps on behalf of users**+Zero-config OAuth flows, automatic token refresh, and complete user isolation—all managed for you.~~++## ~~Key capabilities~~++<CardGroup cols={2}>+ <Card title="800+ pre-configured apps" icon="fa-solid fa-plug">+ ~~OAuth flows, API keys, and credentials for every major platform—no setup required.~~+ </Card>++ <Card title="Automatic token management" icon="fa-solid fa-arrows-rotate">+ ~~Never worry about expired tokens. Composio handles refresh, rotation, and secure storage.~~+ </Card>++ <Card title="Complete user isolation" icon="fa-solid fa-lock">+ ~~Each user's credentials are encrypted and isolated. Perfect for multi-tenant applications.~~+ </Card>++ <Card title="White-label authentication" icon="fa-solid fa-palette">+ ~~Use your own OAuth apps and branded auth screens for a seamless user experience.~~+ </Card>+</CardGroup>++## ~~How it works~~++<CodeGroup>+```python Python+from composio import Composio++composio = Composio(api_key="YOUR_API_KEY")++# Create an authentication link for your user+auth_link = composio.connected_accounts.link(+ user_id="user-123",+ toolkit="github"+)++# User authenticates via the link+print(f"Send this link to user: {auth_link.url}")++# Execute authenticated actions+result = composio.tools.execute(+ "GITHUB_CREATE_REPO",+ user_id="user-123",+ arguments={"name": "my-new-repo"}+)+```++```typescript TypeScript+import { Composio } from '@composio/core';++const composio = new Composio({ apiKey: 'YOUR_API_KEY' });++// Create an authentication link for your user+const authLink = await composio.connectedAccounts.link({+ userId: 'user-123',+ toolkit: 'github'+});++// User authenticates via the link+console.log(`Send this link to user: ${authLink.url}`);++// Execute authenticated actions+const result = await composio.tools.execute('GITHUB_CREATE_REPO', {+ userId: 'user-123',+ arguments: { name: 'my-new-repo' }+});+```+</CodeGroup>++## ~~Use cases~~++### ~~Customer support automation~~+~~Enable support agents to access customer accounts across Zendesk, Intercom, and internal tools—with proper audit trails and permissions.~~++### ~~Sales automation~~+~~Connect CRM, email, and calendar accounts to automate outreach, follow-ups, and meeting scheduling while maintaining personalization.~~++### ~~DevOps workflows~~+~~Authenticate with GitHub, GitLab, AWS, and monitoring tools to automate deployments, incident response, and infrastructure management.~~++### ~~Content management~~+~~Connect social media, CMS, and analytics platforms to schedule posts, manage content, and track performance across channels.~~++## ~~Authentication methods~~++<AccordionGroup>+ <Accordion title="OAuth 2.0">+ ~~Full OAuth flow with automatic token refresh. Supports Google, Microsoft, GitHub, and 500+ other providers.~~+ </Accordion>++ <Accordion title="API Keys">+ ~~Simple key-based authentication for services like OpenAI, Stripe, and SendGrid. Keys are encrypted at rest.~~+ </Accordion>++ <Accordion title="Basic Auth">+ ~~Username/password authentication for legacy systems and internal tools. Credentials are securely stored.~~+ </Accordion>++ <Accordion title="Custom Credentials">+ ~~Support for any authentication method including JWT, session tokens, and proprietary schemes.~~+ </Accordion>+</AccordionGroup>++## ~~Enterprise features~~++<CardGroup cols={3}>+ <Card title="GDPR compliant" icon="fa-solid fa-shield-check">+ ~~Data residency options and right-to-be-forgotten support~~+ </Card>++ <Card title="SOC 2 Type II" icon="fa-solid fa-certificate">+ ~~Annual audits and continuous compliance monitoring~~+ </Card>++ <Card title="HIPAA ready" icon="fa-solid fa-hospital">+ ~~Healthcare-grade security for sensitive data~~+ </Card>+</CardGroup>++## ~~Get started~~++<CardGroup cols={2}>+ <Card+ title="Authentication guide"+ icon="fa-solid fa-book"+ href="/docs/authenticating-tools"+ >+ ~~Learn how to authenticate tools and manage connections~~+ </Card>++ <Card+ title="Custom auth configs"+ icon="fa-solid fa-cog"+ href="/docs/custom-auth-configs"+ >+ ~~Use your own OAuth apps and credentials~~+ </Card>++ <Card+ title="Connected accounts"+ icon="fa-solid fa-users"+ href="/docs/connected-accounts"+ >+ ~~Manage user connections throughout their lifecycle~~+ </Card>++ <Card+ title="White-labeling"+ icon="fa-solid fa-palette"+ href="/tool-router/white-labeling"+ >+ ~~Create branded authentication experiences~~+ </Card>+</CardGroup>\ No newline at end of filediff --git a/fern/pages/src/capabilities/mcp.mdx b/fern/pages/src/capabilities/mcp.mdxnew file mode 100644index 000000000..f027853e1--- /dev/null+++ b/fern/pages/src/capabilities/mcp.mdx@@ -0,0 +1,210 @@+---+title: MCP (Model Context Protocol)+image: "https://og.composio.dev/api/og?title=MCP&description=Universal%20tool%20protocol%20for%20any%20AI%20client"+subtitle: "Universal tool protocol for any AI client"+description: "Connect 800+ tools to Claude Desktop, Continue.dev, and any MCP-compatible client. Framework-agnostic integration with zero code changes."+keywords: "mcp, model context protocol, claude desktop, continue dev, ai tools, framework agnostic, tool server"+hide-nav-links: false+---++~~**Connect 800+ tools to any MCP-compatible AI client**+Works with Claude Desktop, Continue.dev, and custom clients—no code changes needed. Just configure and connect.~~++## ~~Key capabilities~~++<CardGroup cols={2}>+ <Card title="Universal compatibility" icon="fa-solid fa-infinity">+ ~~Works with any MCP client—Claude Desktop, Continue.dev, or your custom implementation.~~+ </Card>++ <Card title="800+ tools instantly" icon="fa-solid fa-rocket">+ ~~All Composio tools available through a single MCP server configuration.~~+ </Card>++ <Card title="Zero code required" icon="fa-solid fa-code-branch">+ ~~Configure once in JSON, use everywhere. No SDK integration needed.~~+ </Card>++ <Card title="Automatic updates" icon="fa-solid fa-arrows-rotate">+ ~~New tools and capabilities added automatically without client updates.~~+ </Card>+</CardGroup>++## ~~How it works~~++<CodeGroup>+```json claude_desktop_config.json+{+ "mcpServers": {+ "composio": {+ "command": "npx",+ "args": [+ "-y",+ "@composio/mcp-server",+ "{YOUR_COMPOSIO_API_KEY}"+ ]+ }+ }+}+```++```python Python SDK Alternative+# Or use the Python MCP server+from composio import Composio++composio = Composio(api_key="YOUR_API_KEY")++# Start MCP server+composio.mcp.start_server(+ port=3000,+ allowed_toolkits=["github", "slack", "gmail"]+)++# Server now available for any MCP client to connect+print("MCP server running at localhost:3000")+```++```typescript TypeScript SDK Alternative+// Or use the TypeScript MCP server+import { Composio } from '@composio/core';++const composio = new Composio({ apiKey: 'YOUR_API_KEY' });++// Start MCP server+await composio.mcp.startServer({+ port: 3000,+ allowedToolkits: ['github', 'slack', 'gmail']+});++// Server now available for any MCP client to connect+console.log('MCP server running at localhost:3000');+```+</CodeGroup>++## ~~Compatible clients~~++<CardGroup cols={3}>+ <Card title="Claude Desktop" icon="fa-solid fa-desktop">+ ~~Native support in Anthropic's desktop application~~+ </Card>++ <Card title="Continue.dev" icon="fa-solid fa-code">+ ~~AI-powered IDE extension for VS Code and JetBrains~~+ </Card>++ <Card title="Custom Clients" icon="fa-solid fa-wrench">+ ~~Build your own MCP client with any language or framework~~+ </Card>+</CardGroup>++## ~~Use cases~~++### ~~IDE-powered development~~+~~Give your IDE assistant the ability to create GitHub issues, search documentation, deploy code, and manage infrastructure—all from natural language.~~++### ~~Desktop AI assistants~~+~~Transform Claude Desktop into a powerful automation tool that can send emails, manage calendars, update CRMs, and interact with any business tool.~~++### ~~Custom AI applications~~+~~Build your own MCP client to create specialized AI assistants with access to your entire tool ecosystem without writing integrations.~~++### ~~Research and analysis~~+~~Enable AI to gather data from multiple sources, compile reports, and take action based on findings—all through a standardized protocol.~~++## ~~MCP vs Native SDK~~++<AccordionGroup>+ <Accordion title="When to use MCP">+ ~~- Working with MCP-compatible clients (Claude Desktop, Continue.dev)~~+ ~~- Want framework-agnostic integration~~+ ~~- Need quick setup without code changes~~+ ~~- Building polyglot applications~~+ </Accordion>++ <Accordion title="When to use Native SDK">+ ~~- Need programmatic control over tool execution~~+ ~~- Want to implement custom authentication flows~~+ ~~- Require response transformations or middleware~~+ ~~- Building production applications with specific requirements~~+ </Accordion>++ <Accordion title="Can I use both?">+ ~~Yes! MCP and Native SDK can work together. Use MCP for desktop tools and Native SDK for your application backend.~~+ </Accordion>+</AccordionGroup>++## ~~Server management~~++<CardGroup cols={2}>+ <Card title="Configuration options" icon="fa-solid fa-cog">+ ~~Control which tools are exposed, set rate limits, and manage permissions~~+ </Card>++ <Card title="Multiple servers" icon="fa-solid fa-server">+ ~~Run different MCP servers for different environments or user groups~~+ </Card>++ <Card title="Authentication" icon="fa-solid fa-key">+ ~~Secure your MCP server with API keys and user-specific access~~+ </Card>++ <Card title="Monitoring" icon="fa-solid fa-chart-line">+ ~~Track usage, debug issues, and monitor performance~~+ </Card>+</CardGroup>++## ~~Setup guides~~++<Steps>+ <Step title="Get your API key">+ ~~Sign up at [app.composio.dev](https://app.composio.dev) and grab your API key~~+ </Step>++ <Step title="Configure your client">+ ~~Add the Composio MCP server to your client's configuration file~~+ </Step>++ <Step title="Authenticate tools">+ ~~Connect your accounts (GitHub, Gmail, etc.) through the Composio dashboard~~+ </Step>++ <Step title="Start using tools">+ ~~Your AI can now access all connected tools through natural language~~+ </Step>+</Steps>++## ~~Get started~~++<CardGroup cols={2}>+ <Card+ title="MCP quickstart"+ icon="fa-solid fa-rocket"+ href="/docs/mcp-quickstart"+ >+ ~~Set up MCP with Claude Desktop in 5 minutes~~+ </Card>++ <Card+ title="Server management"+ icon="fa-solid fa-server"+ href="/docs/mcp-server-management"+ >+ ~~Configure and manage your MCP servers~~+ </Card>++ <Card+ title="MCP providers"+ icon="fa-solid fa-plug"+ href="/docs/mcp-providers"+ >+ ~~Integration guides for different MCP clients~~+ </Card>++ <Card+ title="Troubleshooting"+ icon="fa-solid fa-wrench"+ href="/docs/troubleshooting/mcp"+ >+ ~~Common MCP issues and solutions~~+ </Card>+</CardGroup>\ No newline at end of filediff --git a/fern/pages/src/capabilities/tools.mdx b/fern/pages/src/capabilities/tools.mdxnew file mode 100644index 000000000..88f78465e--- /dev/null+++ b/fern/pages/src/capabilities/tools.mdx@@ -0,0 +1,214 @@+---+title: Tools+image: "https://og.composio.dev/api/og?title=Tools&description=800%2B%20authenticated%20actions%20for%20AI%20agents"+subtitle: "800+ authenticated actions for AI agents"+description: "Give your AI agents the ability to execute real-world actions across 800+ integrations. From GitHub commits to Slack messages—all with user authentication built in."+keywords: "ai tools, agent tools, authenticated actions, tool calling, github actions, slack integration, gmail api"+hide-nav-links: false+---++~~**Give your AI agents the ability to take real-world actions**+800+ pre-built integrations with authentication, error handling, and response formatting—ready to use in one line of code.~~++## ~~Key capabilities~~++<CardGroup cols={2}>+ <Card title="800+ integrations" icon="fa-solid fa-plug">+ ~~GitHub, Slack, Gmail, Jira, Notion, and hundreds more—all pre-configured and ready.~~+ </Card>++ <Card title="User authentication built-in" icon="fa-solid fa-user-lock">+ ~~Every tool execution is scoped to the authenticated user. No credential mixing.~~+ </Card>++ <Card title="Automatic error handling" icon="fa-solid fa-shield">+ ~~Rate limiting, retries, and graceful degradation handled automatically.~~+ </Card>++ <Card title="Structured outputs" icon="fa-solid fa-code">+ ~~Consistent JSON responses optimized for LLM consumption and parsing.~~+ </Card>+</CardGroup>++## ~~How it works~~++<CodeGroup>+```python Python+from composio import Composio++composio = Composio(api_key="YOUR_API_KEY")++# Get tools for a user+tools = composio.tools.get(+ user_id="user-123",+ toolkits=["github", "slack"]+)++# Execute any tool with natural language arguments+result = composio.tools.execute(+ "GITHUB_CREATE_ISSUE",+ user_id="user-123",+ arguments={+ "repo": "my-repo",+ "title": "Bug: Login not working",+ "body": "Users report login failures after update"+ }+)++print(f"Issue created: {result.data['html_url']}")+```++```typescript TypeScript+import { Composio } from '@composio/core';++const composio = new Composio({ apiKey: 'YOUR_API_KEY' });++// Get tools for a user+const tools = await composio.tools.get({+ userId: 'user-123',+ toolkits: ['github', 'slack']+});++// Execute any tool with natural language arguments+const result = await composio.tools.execute('GITHUB_CREATE_ISSUE', {+ userId: 'user-123',+ arguments: {+ repo: 'my-repo',+ title: 'Bug: Login not working',+ body: 'Users report login failures after update'+ }+});++console.log(`Issue created: ${result.data.html_url}`);+```+</CodeGroup>++## ~~Popular integrations~~++<CardGroup cols={4}>+ <Card title="GitHub" icon="fa-brands fa-github">+ ~~Create issues, manage PRs, deploy code~~+ </Card>++ <Card title="Slack" icon="fa-brands fa-slack">+ ~~Send messages, create channels, manage users~~+ </Card>++ <Card title="Gmail" icon="fa-solid fa-envelope">+ ~~Send emails, manage drafts, organize inbox~~+ </Card>++ <Card title="Notion" icon="fa-solid fa-n">+ ~~Create pages, update databases, manage workspace~~+ </Card>++ <Card title="Jira" icon="fa-brands fa-jira">+ ~~Create tickets, update status, manage sprints~~+ </Card>++ <Card title="Linear" icon="fa-solid fa-lines-leaning">+ ~~Track issues, update projects, manage cycles~~+ </Card>++ <Card title="Discord" icon="fa-brands fa-discord">+ ~~Send messages, manage servers, create webhooks~~+ </Card>++ <Card title="HubSpot" icon="fa-solid fa-h">+ ~~Manage contacts, deals, and marketing campaigns~~+ </Card>+</CardGroup>++## ~~Use cases~~++### ~~Customer support automation~~+~~Automatically create support tickets, update CRM records, and send follow-up emails based on customer interactions.~~++### ~~DevOps workflows~~+~~Trigger deployments, create GitHub issues from error logs, and send Slack notifications—all from natural language commands.~~++### ~~Sales automation~~+~~Update CRM records, schedule follow-ups, send personalized emails, and track deal progress across multiple platforms.~~++### ~~Content publishing~~+~~Cross-post to social media, update CMS, schedule publications, and track analytics across all your content channels.~~++## ~~Tool categories~~++<AccordionGroup>+ <Accordion title="Developer tools">+ ~~GitHub, GitLab, Bitbucket, Linear, Jira, PagerDuty, Datadog, Sentry~~+ </Accordion>++ <Accordion title="Communication">+ ~~Slack, Discord, Microsoft Teams, Gmail, Outlook, Twilio, SendGrid~~+ </Accordion>++ <Accordion title="Productivity">+ ~~Notion, Asana, Trello, Monday.com, Airtable, Google Workspace~~+ </Accordion>++ <Accordion title="Sales & Marketing">+ ~~HubSpot, Salesforce, Pipedrive, Mailchimp, ActiveCampaign, Intercom~~+ </Accordion>++ <Accordion title="Social Media">+ ~~Twitter/X, LinkedIn, Facebook, Instagram, YouTube, TikTok~~+ </Accordion>++ <Accordion title="Storage & Files">+ ~~Google Drive, Dropbox, Box, OneDrive, AWS S3, SharePoint~~+ </Accordion>+</AccordionGroup>++## ~~Advanced features~~++<CardGroup cols={3}>+ <Card title="Custom tools" icon="fa-solid fa-wrench">+ ~~Create your own tools with custom logic and integrate any API~~+ </Card>++ <Card title="Tool versioning" icon="fa-solid fa-code-branch">+ ~~Pin specific versions for stability or use latest for new features~~+ </Card>++ <Card title="Response modifiers" icon="fa-solid fa-filter">+ ~~Transform outputs to match your application's needs~~+ </Card>+</CardGroup>++## ~~Get started~~++<CardGroup cols={2}>+ <Card+ title="Browse all toolkits"+ icon="fa-solid fa-grid"+ href="/toolkits/introduction"+ >+ ~~Explore the full catalog of available integrations~~+ </Card>++ <Card+ title="Fetching tools"+ icon="fa-solid fa-download"+ href="/docs/fetching-tools"+ >+ ~~Learn how to retrieve and filter tools for your agents~~+ </Card>++ <Card+ title="Executing tools"+ icon="fa-solid fa-play"+ href="/docs/executing-tools"+ >+ ~~Execute tools and handle responses in your application~~+ </Card>++ <Card+ title="Custom tools"+ icon="fa-solid fa-hammer"+ href="/docs/custom-tools"+ >+ ~~Build your own tools for proprietary systems~~+ </Card>+</CardGroup>\ No newline at end of filediff --git a/fern/pages/src/capabilities/triggers.mdx b/fern/pages/src/capabilities/triggers.mdxnew file mode 100644index 000000000..66c2b922a--- /dev/null+++ b/fern/pages/src/capabilities/triggers.mdx@@ -0,0 +1,246 @@+---+title: Triggers+image: "https://og.composio.dev/api/og?title=Triggers&description=Real-time%20events%20from%20800%2B%20integrations"+subtitle: "Real-time events from 800+ integrations"+description: "React to events as they happen across your connected services. From GitHub commits to Slack messages—build event-driven AI workflows with zero webhook infrastructure."+keywords: "webhooks, triggers, real-time events, event-driven, github webhooks, slack events, automation"+hide-nav-links: false+---++~~**Build event-driven AI workflows without managing webhooks**+Automatically react to events from GitHub, Slack, Gmail, and 800+ other services—all webhooks and polling handled for you.~~++## ~~Key capabilities~~++<CardGroup cols={2}>+ <Card title="Real-time event streams" icon="fa-solid fa-bolt">+ ~~Instant notifications when events occur across any connected service.~~+ </Card>++ <Card title="Zero webhook setup" icon="fa-solid fa-plug-circle-xmark">+ ~~No need to configure endpoints, manage SSL, or handle retries—we do it all.~~+ </Card>++ <Card title="Unified event format" icon="fa-solid fa-layer-group">+ ~~Consistent event structure across all services for easier processing.~~+ </Card>++ <Card title="Built-in filtering" icon="fa-solid fa-filter">+ ~~Filter events by type, user, or custom criteria before they reach your app.~~+ </Card>+</CardGroup>++## ~~How it works~~++<CodeGroup>+```python Python+from composio import Composio++composio = Composio(api_key="YOUR_API_KEY")++# Set up a trigger for GitHub push events+trigger = composio.triggers.subscribe(+ user_id="user-123",+ trigger_name="GITHUB_PUSH_EVENT",+ config={+ "repository": "my-repo",+ "branch": "main"+ }+)++# Handle incoming events[email protected]_event+def handle_push(event):+ print(f"New commit: {event['commit_message']}")++ # Automatically create a deployment+ composio.tools.execute(+ "VERCEL_CREATE_DEPLOYMENT",+ user_id="user-123",+ arguments={+ "repo": event["repository"],+ "branch": event["branch"]+ }+ )+```++```typescript TypeScript+import { Composio } from '@composio/core';++const composio = new Composio({ apiKey: 'YOUR_API_KEY' });++// Set up a trigger for GitHub push events+const trigger = await composio.triggers.subscribe({+ userId: 'user-123',+ triggerName: 'GITHUB_PUSH_EVENT',+ config: {+ repository: 'my-repo',+ branch: 'main'+ }+});++// Handle incoming events+trigger.onEvent((event) => {+ console.log(`New commit: ${event.commit_message}`);++ // Automatically create a deployment+ composio.tools.execute('VERCEL_CREATE_DEPLOYMENT', {+ userId: 'user-123',+ arguments: {+ repo: event.repository,+ branch: event.branch+ }+ });+});+```+</CodeGroup>++## ~~Popular triggers~~++<CardGroup cols={4}>+ <Card title="GitHub" icon="fa-brands fa-github">+ ~~Push, PR, issue, release, star events~~+ </Card>++ <Card title="Slack" icon="fa-brands fa-slack">+ ~~Message, reaction, channel, member events~~+ </Card>++ <Card title="Gmail" icon="fa-solid fa-envelope">+ ~~New email, label change, attachment events~~+ </Card>++ <Card title="Calendar" icon="fa-solid fa-calendar">+ ~~Event created, updated, reminder events~~+ </Card>++ <Card title="Stripe" icon="fa-brands fa-stripe">+ ~~Payment, subscription, invoice events~~+ </Card>++ <Card title="Jira" icon="fa-brands fa-jira">+ ~~Issue created, status change, sprint events~~+ </Card>++ <Card title="HubSpot" icon="fa-solid fa-h">+ ~~Contact, deal, ticket activity events~~+ </Card>++ <Card title="Discord" icon="fa-brands fa-discord">+ ~~Message, reaction, member join events~~+ </Card>+</CardGroup>++## ~~Use cases~~++### ~~Automated DevOps~~+~~Trigger deployments on GitHub pushes, create Jira tickets from Sentry errors, and send Slack notifications for critical alerts—all automatically.~~++### ~~Customer success automation~~+~~React to support tickets, customer emails, and chat messages to automatically update CRM records and trigger follow-up actions.~~++### ~~Content workflow automation~~+~~Publish blog posts when documents are approved, cross-post to social media on content updates, and trigger translations for new content.~~++### ~~Sales pipeline automation~~+~~Update deal stages based on email interactions, schedule follow-ups from calendar events, and sync activity across all sales tools.~~++## ~~Event types~~++<AccordionGroup>+ <Accordion title="Repository events">+ ~~Push, pull request, issue, release, star, fork, branch creation/deletion~~+ </Accordion>++ <Accordion title="Communication events">+ ~~Message sent/received, channel created, member joined, reaction added~~+ </Accordion>++ <Accordion title="Document events">+ ~~File created/updated, page edited, comment added, permission changed~~+ </Accordion>++ <Accordion title="Calendar events">+ ~~Event created/updated/deleted, attendee response, reminder triggered~~+ </Accordion>++ <Accordion title="Payment events">+ ~~Payment succeeded/failed, subscription created/cancelled, invoice paid~~+ </Accordion>++ <Accordion title="Workflow events">+ ~~Task created/completed, status changed, assignee updated, due date changed~~+ </Accordion>+</AccordionGroup>++## ~~Advanced features~~++<CardGroup cols={3}>+ <Card title="Event filtering" icon="fa-solid fa-filter">+ ~~Filter events before they reach your app to reduce noise~~+ </Card>++ <Card title="Batch processing" icon="fa-solid fa-layer-group">+ ~~Group related events for efficient bulk processing~~+ </Card>++ <Card title="Replay events" icon="fa-solid fa-clock-rotate-left">+ ~~Replay historical events for testing or recovery~~+ </Card>+</CardGroup>++## ~~Reliability guarantees~~++<CardGroup cols={2}>+ <Card title="At-least-once delivery" icon="fa-solid fa-check-double">+ ~~Every event is guaranteed to be delivered at least once~~+ </Card>++ <Card title="Automatic retries" icon="fa-solid fa-rotate">+ ~~Failed deliveries are automatically retried with exponential backoff~~+ </Card>++ <Card title="Event ordering" icon="fa-solid fa-arrow-down-1-9">+ ~~Events from the same source maintain their chronological order~~+ </Card>++ <Card title="Idempotency" icon="fa-solid fa-fingerprint">+ ~~Each event has a unique ID to prevent duplicate processing~~+ </Card>+</CardGroup>++## ~~Get started~~++<CardGroup cols={2}>+ <Card+ title="Using triggers"+ icon="fa-solid fa-bolt"+ href="/docs/using-triggers"+ >+ ~~Learn how to subscribe to and handle trigger events~~+ </Card>++ <Card+ title="Available triggers"+ icon="fa-solid fa-list"+ href="/toolkits/introduction"+ >+ ~~Browse all available triggers by toolkit~~+ </Card>++ <Card+ title="Event-driven workflows"+ icon="fa-solid fa-diagram-project"+ href="/examples/slack-summariser"+ >+ ~~See real examples of trigger-based automations~~+ </Card>++ <Card+ title="Troubleshooting"+ icon="fa-solid fa-wrench"+ href="/docs/troubleshooting/triggers"+ >+ ~~Debug common trigger issues and solutions~~+ </Card>+</CardGroup>\ No newline at end of file