Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
navigation high level changes
Sushmithamallesh committed
Nov 25, 2025 at 09:58 UTC
4fbd95270cbe540690ca4cfdda952c8b095bca5c
5 files changed
+917
-8
fern/docs.yml
+83
-8
@@ -90,10 +90,16 @@ redirects:
90
destination: /type-script
91
- source: /sdk-reference/type-script/:path
92
destination: /type-script/:path
93
+- source: /docs/tool-router/quick-start
94
+ destination: /tool-router/overview
95
tabs:
96
docs:
97
display-name: Docs
98
slug: docs
99
+ tool-router:
100
+ display-name: Tool Router
101
+ icon: fa-sparkles
102
+ slug: tool-router
103
providers:
104
display-name: Providers
105
skip-slug: true
@@ -128,6 +134,24 @@ navigation:
134
- changelog: ./pages/src/changelog
135
title: Changelog
136
slug: changelog
137
+ - section: Capabilities
138
+ icon: fa-layer-group
139
+ skip-slug: true
140
+ contents:
141
+ - link: Tool Router
142
+ href: /tool-router/overview
143
+ - page: Managed Authentication
144
+ path: pages/dist/capabilities/managed-authentication.mdx
145
+ slug: managed-authentication
146
+ - page: Tools
147
+ path: pages/dist/capabilities/tools.mdx
148
+ slug: tools
149
+ - page: MCP
150
+ path: pages/dist/capabilities/mcp.mdx
151
+ slug: mcp
152
+ - page: Triggers
153
+ path: pages/dist/capabilities/triggers.mdx
154
+ slug: triggers
155
- section: Tools and Triggers
156
icon: fa-light fa-wrench
157
skip-slug: true
@@ -194,13 +218,6 @@ navigation:
218
- page: Providers
219
path: pages/dist/mcp/providers.mdx
220
slug: mcp-providers
197
- - section: Tool Router (Beta)
198
- icon: fa-light fa-flask
199
- skip-slug: true
200
- contents:
201
- - page: Quick Start
202
- path: pages/dist/tool-router/quick-start.mdx
203
- slug: tool-router/quick-start
221
- section: Resources
222
icon: fa-light fa-book
223
skip-slug: true
@@ -253,6 +270,64 @@ navigation:
270
- page: Triggers
271
path: pages/dist/resources/troubleshooting/triggers.mdx
272
slug: triggers
273
+- tab: tool-router
274
+ layout:
275
+ - section: Get Started
276
+ icon: fa-light fa-rocket
277
+ skip-slug: true
278
+ contents:
279
+ - page: Overview
280
+ path: pages/dist/tool-router/overview.mdx
281
+ slug: overview
282
+ - page: Quickstart
283
+ path: pages/dist/tool-router/quickstart.mdx
284
+ slug: quickstart
285
+ - section: Core Concepts
286
+ icon: fa-light fa-brain
287
+ skip-slug: true
288
+ contents:
289
+ - page: Understanding Tool Router
290
+ path: pages/dist/tool-router/understanding-tool-router.mdx
291
+ slug: understanding-tool-router
292
+ - page: Sessions
293
+ path: pages/dist/tool-router/sessions.mdx
294
+ slug: sessions
295
+ - page: Meta-Tools
296
+ path: pages/dist/tool-router/meta-tools.mdx
297
+ slug: meta-tools
298
+ - section: Configuration
299
+ icon: fa-light fa-cog
300
+ skip-slug: true
301
+ contents:
302
+ - page: Toolkit Management
303
+ path: pages/dist/tool-router/toolkit-management.mdx
304
+ slug: toolkit-management
305
+ - page: Permissions
306
+ path: pages/dist/tool-router/permissions.mdx
307
+ slug: permissions
308
+ - section: Authentication
309
+ icon: fa-light fa-key
310
+ skip-slug: true
311
+ contents:
312
+ - page: Authentication Flows
313
+ path: pages/dist/tool-router/authentication-flows.mdx
314
+ slug: authentication-flows
315
+ - page: White-Labeling
316
+ path: pages/dist/tool-router/white-labeling.mdx
317
+ slug: white-labeling
318
+ - section: Integration
319
+ icon: fa-light fa-plug
320
+ skip-slug: true
321
+ contents:
322
+ - page: MCP Integration
323
+ path: pages/dist/tool-router/mcp-integration.mdx
324
+ slug: mcp-integration
325
+ - page: Native SDK
326
+ path: pages/dist/tool-router/native-sdk.mdx
327
+ slug: native-sdk
328
+ - page: Framework Examples
329
+ path: pages/dist/tool-router/framework-examples.mdx
330
+ slug: framework-examples
331
- tab: providers
332
layout:
333
- section: Supported Providers
@@ -417,4 +492,4 @@ navigation:
492
contents:
493
- page: Tool Generator
494
path: pages/dist/examples/tool-generator/tool-generator.mdx
420
- slug: examples/tool-generator
495
+ slug: examples/tool-generator
\ No newline at end of file
fern/pages/src/capabilities/managed-authentication.mdx
new
+164
@@ -0,0 +1,164 @@
1
+---
2
+title: Managed Authentication
3
+image: "https://og.composio.dev/api/og?title=Managed%20Authentication&description=Enterprise-grade%20authentication%20for%20AI%20agents"
4
+subtitle: "Enterprise-grade authentication for AI agents"
5
+description: "Let your AI agents authenticate with 800+ apps on behalf of users. OAuth, API keys, user isolation, and white-labeling built in."
6
+keywords: "managed authentication, ai agent auth, oauth, api keys, user isolation, white-labeling, connected accounts"
7
+hide-nav-links: false
8
+---
9
+
10
+~~**Let your AI agents authenticate with 800+ apps on behalf of users**
11
+Zero-config OAuth flows, automatic token refresh, and complete user isolation—all managed for you.~~
12
+
13
+## ~~Key capabilities~~
14
+
15
+<CardGroup cols={2}>
16
+ <Card title="800+ pre-configured apps" icon="fa-solid fa-plug">
17
+ ~~OAuth flows, API keys, and credentials for every major platform—no setup required.~~
18
+ </Card>
19
+
20
+ <Card title="Automatic token management" icon="fa-solid fa-arrows-rotate">
21
+ ~~Never worry about expired tokens. Composio handles refresh, rotation, and secure storage.~~
22
+ </Card>
23
+
24
+ <Card title="Complete user isolation" icon="fa-solid fa-lock">
25
+ ~~Each user's credentials are encrypted and isolated. Perfect for multi-tenant applications.~~
26
+ </Card>
27
+
28
+ <Card title="White-label authentication" icon="fa-solid fa-palette">
29
+ ~~Use your own OAuth apps and branded auth screens for a seamless user experience.~~
30
+ </Card>
31
+</CardGroup>
32
+
33
+## ~~How it works~~
34
+
35
+<CodeGroup>
36
+```python Python
37
+from composio import Composio
38
+
39
+composio = Composio(api_key="YOUR_API_KEY")
40
+
41
+# Create an authentication link for your user
42
+auth_link = composio.connected_accounts.link(
43
+ user_id="user-123",
44
+ toolkit="github"
45
+)
46
+
47
+# User authenticates via the link
48
+print(f"Send this link to user: {auth_link.url}")
49
+
50
+# Execute authenticated actions
51
+result = composio.tools.execute(
52
+ "GITHUB_CREATE_REPO",
53
+ user_id="user-123",
54
+ arguments={"name": "my-new-repo"}
55
+)
56
+```
57
+
58
+```typescript TypeScript
59
+import { Composio } from '@composio/core';
60
+
61
+const composio = new Composio({ apiKey: 'YOUR_API_KEY' });
62
+
63
+// Create an authentication link for your user
64
+const authLink = await composio.connectedAccounts.link({
65
+ userId: 'user-123',
66
+ toolkit: 'github'
67
+});
68
+
69
+// User authenticates via the link
70
+console.log(`Send this link to user: ${authLink.url}`);
71
+
72
+// Execute authenticated actions
73
+const result = await composio.tools.execute('GITHUB_CREATE_REPO', {
74
+ userId: 'user-123',
75
+ arguments: { name: 'my-new-repo' }
76
+});
77
+```
78
+</CodeGroup>
79
+
80
+## ~~Use cases~~
81
+
82
+### ~~Customer support automation~~
83
+~~Enable support agents to access customer accounts across Zendesk, Intercom, and internal tools—with proper audit trails and permissions.~~
84
+
85
+### ~~Sales automation~~
86
+~~Connect CRM, email, and calendar accounts to automate outreach, follow-ups, and meeting scheduling while maintaining personalization.~~
87
+
88
+### ~~DevOps workflows~~
89
+~~Authenticate with GitHub, GitLab, AWS, and monitoring tools to automate deployments, incident response, and infrastructure management.~~
90
+
91
+### ~~Content management~~
92
+~~Connect social media, CMS, and analytics platforms to schedule posts, manage content, and track performance across channels.~~
93
+
94
+## ~~Authentication methods~~
95
+
96
+<AccordionGroup>
97
+ <Accordion title="OAuth 2.0">
98
+ ~~Full OAuth flow with automatic token refresh. Supports Google, Microsoft, GitHub, and 500+ other providers.~~
99
+ </Accordion>
100
+
101
+ <Accordion title="API Keys">
102
+ ~~Simple key-based authentication for services like OpenAI, Stripe, and SendGrid. Keys are encrypted at rest.~~
103
+ </Accordion>
104
+
105
+ <Accordion title="Basic Auth">
106
+ ~~Username/password authentication for legacy systems and internal tools. Credentials are securely stored.~~
107
+ </Accordion>
108
+
109
+ <Accordion title="Custom Credentials">
110
+ ~~Support for any authentication method including JWT, session tokens, and proprietary schemes.~~
111
+ </Accordion>
112
+</AccordionGroup>
113
+
114
+## ~~Enterprise features~~
115
+
116
+<CardGroup cols={3}>
117
+ <Card title="GDPR compliant" icon="fa-solid fa-shield-check">
118
+ ~~Data residency options and right-to-be-forgotten support~~
119
+ </Card>
120
+
121
+ <Card title="SOC 2 Type II" icon="fa-solid fa-certificate">
122
+ ~~Annual audits and continuous compliance monitoring~~
123
+ </Card>
124
+
125
+ <Card title="HIPAA ready" icon="fa-solid fa-hospital">
126
+ ~~Healthcare-grade security for sensitive data~~
127
+ </Card>
128
+</CardGroup>
129
+
130
+## ~~Get started~~
131
+
132
+<CardGroup cols={2}>
133
+ <Card
134
+ title="Authentication guide"
135
+ icon="fa-solid fa-book"
136
+ href="/docs/authenticating-tools"
137
+ >
138
+ ~~Learn how to authenticate tools and manage connections~~
139
+ </Card>
140
+
141
+ <Card
142
+ title="Custom auth configs"
143
+ icon="fa-solid fa-cog"
144
+ href="/docs/custom-auth-configs"
145
+ >
146
+ ~~Use your own OAuth apps and credentials~~
147
+ </Card>
148
+
149
+ <Card
150
+ title="Connected accounts"
151
+ icon="fa-solid fa-users"
152
+ href="/docs/connected-accounts"
153
+ >
154
+ ~~Manage user connections throughout their lifecycle~~
155
+ </Card>
156
+
157
+ <Card
158
+ title="White-labeling"
159
+ icon="fa-solid fa-palette"
160
+ href="/tool-router/white-labeling"
161
+ >
162
+ ~~Create branded authentication experiences~~
163
+ </Card>
164
+</CardGroup>
\ No newline at end of file
fern/pages/src/capabilities/mcp.mdx
new
+210
@@ -0,0 +1,210 @@
1
+---
2
+title: MCP (Model Context Protocol)
3
+image: "https://og.composio.dev/api/og?title=MCP&description=Universal%20tool%20protocol%20for%20any%20AI%20client"
4
+subtitle: "Universal tool protocol for any AI client"
5
+description: "Connect 800+ tools to Claude Desktop, Continue.dev, and any MCP-compatible client. Framework-agnostic integration with zero code changes."
6
+keywords: "mcp, model context protocol, claude desktop, continue dev, ai tools, framework agnostic, tool server"
7
+hide-nav-links: false
8
+---
9
+
10
+~~**Connect 800+ tools to any MCP-compatible AI client**
11
+Works with Claude Desktop, Continue.dev, and custom clients—no code changes needed. Just configure and connect.~~
12
+
13
+## ~~Key capabilities~~
14
+
15
+<CardGroup cols={2}>
16
+ <Card title="Universal compatibility" icon="fa-solid fa-infinity">
17
+ ~~Works with any MCP client—Claude Desktop, Continue.dev, or your custom implementation.~~
18
+ </Card>
19
+
20
+ <Card title="800+ tools instantly" icon="fa-solid fa-rocket">
21
+ ~~All Composio tools available through a single MCP server configuration.~~
22
+ </Card>
23
+
24
+ <Card title="Zero code required" icon="fa-solid fa-code-branch">
25
+ ~~Configure once in JSON, use everywhere. No SDK integration needed.~~
26
+ </Card>
27
+
28
+ <Card title="Automatic updates" icon="fa-solid fa-arrows-rotate">
29
+ ~~New tools and capabilities added automatically without client updates.~~
30
+ </Card>
31
+</CardGroup>
32
+
33
+## ~~How it works~~
34
+
35
+<CodeGroup>
36
+```json claude_desktop_config.json
37
+{
38
+ "mcpServers": {
39
+ "composio": {
40
+ "command": "npx",
41
+ "args": [
42
+ "-y",
43
+ "@composio/mcp-server",
44
+ "{YOUR_COMPOSIO_API_KEY}"
45
+ ]
46
+ }
47
+ }
48
+}
49
+```
50
+
51
+```python Python SDK Alternative
52
+# Or use the Python MCP server
53
+from composio import Composio
54
+
55
+composio = Composio(api_key="YOUR_API_KEY")
56
+
57
+# Start MCP server
58
+composio.mcp.start_server(
59
+ port=3000,
60
+ allowed_toolkits=["github", "slack", "gmail"]
61
+)
62
+
63
+# Server now available for any MCP client to connect
64
+print("MCP server running at localhost:3000")
65
+```
66
+
67
+```typescript TypeScript SDK Alternative
68
+// Or use the TypeScript MCP server
69
+import { Composio } from '@composio/core';
70
+
71
+const composio = new Composio({ apiKey: 'YOUR_API_KEY' });
72
+
73
+// Start MCP server
74
+await composio.mcp.startServer({
75
+ port: 3000,
76
+ allowedToolkits: ['github', 'slack', 'gmail']
77
+});
78
+
79
+// Server now available for any MCP client to connect
80
+console.log('MCP server running at localhost:3000');
81
+```
82
+</CodeGroup>
83
+
84
+## ~~Compatible clients~~
85
+
86
+<CardGroup cols={3}>
87
+ <Card title="Claude Desktop" icon="fa-solid fa-desktop">
88
+ ~~Native support in Anthropic's desktop application~~
89
+ </Card>
90
+
91
+ <Card title="Continue.dev" icon="fa-solid fa-code">
92
+ ~~AI-powered IDE extension for VS Code and JetBrains~~
93
+ </Card>
94
+
95
+ <Card title="Custom Clients" icon="fa-solid fa-wrench">
96
+ ~~Build your own MCP client with any language or framework~~
97
+ </Card>
98
+</CardGroup>
99
+
100
+## ~~Use cases~~
101
+
102
+### ~~IDE-powered development~~
103
+~~Give your IDE assistant the ability to create GitHub issues, search documentation, deploy code, and manage infrastructure—all from natural language.~~
104
+
105
+### ~~Desktop AI assistants~~
106
+~~Transform Claude Desktop into a powerful automation tool that can send emails, manage calendars, update CRMs, and interact with any business tool.~~
107
+
108
+### ~~Custom AI applications~~
109
+~~Build your own MCP client to create specialized AI assistants with access to your entire tool ecosystem without writing integrations.~~
110
+
111
+### ~~Research and analysis~~
112
+~~Enable AI to gather data from multiple sources, compile reports, and take action based on findings—all through a standardized protocol.~~
113
+
114
+## ~~MCP vs Native SDK~~
115
+
116
+<AccordionGroup>
117
+ <Accordion title="When to use MCP">
118
+ ~~- Working with MCP-compatible clients (Claude Desktop, Continue.dev)~~
119
+ ~~- Want framework-agnostic integration~~
120
+ ~~- Need quick setup without code changes~~
121
+ ~~- Building polyglot applications~~
122
+ </Accordion>
123
+
124
+ <Accordion title="When to use Native SDK">
125
+ ~~- Need programmatic control over tool execution~~
126
+ ~~- Want to implement custom authentication flows~~
127
+ ~~- Require response transformations or middleware~~
128
+ ~~- Building production applications with specific requirements~~
129
+ </Accordion>
130
+
131
+ <Accordion title="Can I use both?">
132
+ ~~Yes! MCP and Native SDK can work together. Use MCP for desktop tools and Native SDK for your application backend.~~
133
+ </Accordion>
134
+</AccordionGroup>
135
+
136
+## ~~Server management~~
137
+
138
+<CardGroup cols={2}>
139
+ <Card title="Configuration options" icon="fa-solid fa-cog">
140
+ ~~Control which tools are exposed, set rate limits, and manage permissions~~
141
+ </Card>
142
+
143
+ <Card title="Multiple servers" icon="fa-solid fa-server">
144
+ ~~Run different MCP servers for different environments or user groups~~
145
+ </Card>
146
+
147
+ <Card title="Authentication" icon="fa-solid fa-key">
148
+ ~~Secure your MCP server with API keys and user-specific access~~
149
+ </Card>
150
+
151
+ <Card title="Monitoring" icon="fa-solid fa-chart-line">
152
+ ~~Track usage, debug issues, and monitor performance~~
153
+ </Card>
154
+</CardGroup>
155
+
156
+## ~~Setup guides~~
157
+
158
+<Steps>
159
+ <Step title="Get your API key">
160
+ ~~Sign up at [app.composio.dev](https://app.composio.dev) and grab your API key~~
161
+ </Step>
162
+
163
+ <Step title="Configure your client">
164
+ ~~Add the Composio MCP server to your client's configuration file~~
165
+ </Step>
166
+
167
+ <Step title="Authenticate tools">
168
+ ~~Connect your accounts (GitHub, Gmail, etc.) through the Composio dashboard~~
169
+ </Step>
170
+
171
+ <Step title="Start using tools">
172
+ ~~Your AI can now access all connected tools through natural language~~
173
+ </Step>
174
+</Steps>
175
+
176
+## ~~Get started~~
177
+
178
+<CardGroup cols={2}>
179
+ <Card
180
+ title="MCP quickstart"
181
+ icon="fa-solid fa-rocket"
182
+ href="/docs/mcp-quickstart"
183
+ >
184
+ ~~Set up MCP with Claude Desktop in 5 minutes~~
185
+ </Card>
186
+
187
+ <Card
188
+ title="Server management"
189
+ icon="fa-solid fa-server"
190
+ href="/docs/mcp-server-management"
191
+ >
192
+ ~~Configure and manage your MCP servers~~
193
+ </Card>
194
+
195
+ <Card
196
+ title="MCP providers"
197
+ icon="fa-solid fa-plug"
198
+ href="/docs/mcp-providers"
199
+ >
200
+ ~~Integration guides for different MCP clients~~
201
+ </Card>
202
+
203
+ <Card
204
+ title="Troubleshooting"
205
+ icon="fa-solid fa-wrench"
206
+ href="/docs/troubleshooting/mcp"
207
+ >
208
+ ~~Common MCP issues and solutions~~
209
+ </Card>
210
+</CardGroup>
\ No newline at end of file
fern/pages/src/capabilities/tools.mdx
new
+214
@@ -0,0 +1,214 @@
1
+---
2
+title: Tools
3
+image: "https://og.composio.dev/api/og?title=Tools&description=800%2B%20authenticated%20actions%20for%20AI%20agents"
4
+subtitle: "800+ authenticated actions for AI agents"
5
+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."
6
+keywords: "ai tools, agent tools, authenticated actions, tool calling, github actions, slack integration, gmail api"
7
+hide-nav-links: false
8
+---
9
+
10
+~~**Give your AI agents the ability to take real-world actions**
11
+800+ pre-built integrations with authentication, error handling, and response formatting—ready to use in one line of code.~~
12
+
13
+## ~~Key capabilities~~
14
+
15
+<CardGroup cols={2}>
16
+ <Card title="800+ integrations" icon="fa-solid fa-plug">
17
+ ~~GitHub, Slack, Gmail, Jira, Notion, and hundreds more—all pre-configured and ready.~~
18
+ </Card>
19
+
20
+ <Card title="User authentication built-in" icon="fa-solid fa-user-lock">
21
+ ~~Every tool execution is scoped to the authenticated user. No credential mixing.~~
22
+ </Card>
23
+
24
+ <Card title="Automatic error handling" icon="fa-solid fa-shield">
25
+ ~~Rate limiting, retries, and graceful degradation handled automatically.~~
26
+ </Card>
27
+
28
+ <Card title="Structured outputs" icon="fa-solid fa-code">
29
+ ~~Consistent JSON responses optimized for LLM consumption and parsing.~~
30
+ </Card>
31
+</CardGroup>
32
+
33
+## ~~How it works~~
34
+
35
+<CodeGroup>
36
+```python Python
37
+from composio import Composio
38
+
39
+composio = Composio(api_key="YOUR_API_KEY")
40
+
41
+# Get tools for a user
42
+tools = composio.tools.get(
43
+ user_id="user-123",
44
+ toolkits=["github", "slack"]
45
+)
46
+
47
+# Execute any tool with natural language arguments
48
+result = composio.tools.execute(
49
+ "GITHUB_CREATE_ISSUE",
50
+ user_id="user-123",
51
+ arguments={
52
+ "repo": "my-repo",
53
+ "title": "Bug: Login not working",
54
+ "body": "Users report login failures after update"
55
+ }
56
+)
57
+
58
+print(f"Issue created: {result.data['html_url']}")
59
+```
60
+
61
+```typescript TypeScript
62
+import { Composio } from '@composio/core';
63
+
64
+const composio = new Composio({ apiKey: 'YOUR_API_KEY' });
65
+
66
+// Get tools for a user
67
+const tools = await composio.tools.get({
68
+ userId: 'user-123',
69
+ toolkits: ['github', 'slack']
70
+});
71
+
72
+// Execute any tool with natural language arguments
73
+const result = await composio.tools.execute('GITHUB_CREATE_ISSUE', {
74
+ userId: 'user-123',
75
+ arguments: {
76
+ repo: 'my-repo',
77
+ title: 'Bug: Login not working',
78
+ body: 'Users report login failures after update'
79
+ }
80
+});
81
+
82
+console.log(`Issue created: ${result.data.html_url}`);
83
+```
84
+</CodeGroup>
85
+
86
+## ~~Popular integrations~~
87
+
88
+<CardGroup cols={4}>
89
+ <Card title="GitHub" icon="fa-brands fa-github">
90
+ ~~Create issues, manage PRs, deploy code~~
91
+ </Card>
92
+
93
+ <Card title="Slack" icon="fa-brands fa-slack">
94
+ ~~Send messages, create channels, manage users~~
95
+ </Card>
96
+
97
+ <Card title="Gmail" icon="fa-solid fa-envelope">
98
+ ~~Send emails, manage drafts, organize inbox~~
99
+ </Card>
100
+
101
+ <Card title="Notion" icon="fa-solid fa-n">
102
+ ~~Create pages, update databases, manage workspace~~
103
+ </Card>
104
+
105
+ <Card title="Jira" icon="fa-brands fa-jira">
106
+ ~~Create tickets, update status, manage sprints~~
107
+ </Card>
108
+
109
+ <Card title="Linear" icon="fa-solid fa-lines-leaning">
110
+ ~~Track issues, update projects, manage cycles~~
111
+ </Card>
112
+
113
+ <Card title="Discord" icon="fa-brands fa-discord">
114
+ ~~Send messages, manage servers, create webhooks~~
115
+ </Card>
116
+
117
+ <Card title="HubSpot" icon="fa-solid fa-h">
118
+ ~~Manage contacts, deals, and marketing campaigns~~
119
+ </Card>
120
+</CardGroup>
121
+
122
+## ~~Use cases~~
123
+
124
+### ~~Customer support automation~~
125
+~~Automatically create support tickets, update CRM records, and send follow-up emails based on customer interactions.~~
126
+
127
+### ~~DevOps workflows~~
128
+~~Trigger deployments, create GitHub issues from error logs, and send Slack notifications—all from natural language commands.~~
129
+
130
+### ~~Sales automation~~
131
+~~Update CRM records, schedule follow-ups, send personalized emails, and track deal progress across multiple platforms.~~
132
+
133
+### ~~Content publishing~~
134
+~~Cross-post to social media, update CMS, schedule publications, and track analytics across all your content channels.~~
135
+
136
+## ~~Tool categories~~
137
+
138
+<AccordionGroup>
139
+ <Accordion title="Developer tools">
140
+ ~~GitHub, GitLab, Bitbucket, Linear, Jira, PagerDuty, Datadog, Sentry~~
141
+ </Accordion>
142
+
143
+ <Accordion title="Communication">
144
+ ~~Slack, Discord, Microsoft Teams, Gmail, Outlook, Twilio, SendGrid~~
145
+ </Accordion>
146
+
147
+ <Accordion title="Productivity">
148
+ ~~Notion, Asana, Trello, Monday.com, Airtable, Google Workspace~~
149
+ </Accordion>
150
+
151
+ <Accordion title="Sales & Marketing">
152
+ ~~HubSpot, Salesforce, Pipedrive, Mailchimp, ActiveCampaign, Intercom~~
153
+ </Accordion>
154
+
155
+ <Accordion title="Social Media">
156
+ ~~Twitter/X, LinkedIn, Facebook, Instagram, YouTube, TikTok~~
157
+ </Accordion>
158
+
159
+ <Accordion title="Storage & Files">
160
+ ~~Google Drive, Dropbox, Box, OneDrive, AWS S3, SharePoint~~
161
+ </Accordion>
162
+</AccordionGroup>
163
+
164
+## ~~Advanced features~~
165
+
166
+<CardGroup cols={3}>
167
+ <Card title="Custom tools" icon="fa-solid fa-wrench">
168
+ ~~Create your own tools with custom logic and integrate any API~~
169
+ </Card>
170
+
171
+ <Card title="Tool versioning" icon="fa-solid fa-code-branch">
172
+ ~~Pin specific versions for stability or use latest for new features~~
173
+ </Card>
174
+
175
+ <Card title="Response modifiers" icon="fa-solid fa-filter">
176
+ ~~Transform outputs to match your application's needs~~
177
+ </Card>
178
+</CardGroup>
179
+
180
+## ~~Get started~~
181
+
182
+<CardGroup cols={2}>
183
+ <Card
184
+ title="Browse all toolkits"
185
+ icon="fa-solid fa-grid"
186
+ href="/toolkits/introduction"
187
+ >
188
+ ~~Explore the full catalog of available integrations~~
189
+ </Card>
190
+
191
+ <Card
192
+ title="Fetching tools"
193
+ icon="fa-solid fa-download"
194
+ href="/docs/fetching-tools"
195
+ >
196
+ ~~Learn how to retrieve and filter tools for your agents~~
197
+ </Card>
198
+
199
+ <Card
200
+ title="Executing tools"
201
+ icon="fa-solid fa-play"
202
+ href="/docs/executing-tools"
203
+ >
204
+ ~~Execute tools and handle responses in your application~~
205
+ </Card>
206
+
207
+ <Card
208
+ title="Custom tools"
209
+ icon="fa-solid fa-hammer"
210
+ href="/docs/custom-tools"
211
+ >
212
+ ~~Build your own tools for proprietary systems~~
213
+ </Card>
214
+</CardGroup>
\ No newline at end of file
fern/pages/src/capabilities/triggers.mdx
new
+246
@@ -0,0 +1,246 @@
1
+---
2
+title: Triggers
3
+image: "https://og.composio.dev/api/og?title=Triggers&description=Real-time%20events%20from%20800%2B%20integrations"
4
+subtitle: "Real-time events from 800+ integrations"
5
+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."
6
+keywords: "webhooks, triggers, real-time events, event-driven, github webhooks, slack events, automation"
7
+hide-nav-links: false
8
+---
9
+
10
+~~**Build event-driven AI workflows without managing webhooks**
11
+Automatically react to events from GitHub, Slack, Gmail, and 800+ other services—all webhooks and polling handled for you.~~
12
+
13
+## ~~Key capabilities~~
14
+
15
+<CardGroup cols={2}>
16
+ <Card title="Real-time event streams" icon="fa-solid fa-bolt">
17
+ ~~Instant notifications when events occur across any connected service.~~
18
+ </Card>
19
+
20
+ <Card title="Zero webhook setup" icon="fa-solid fa-plug-circle-xmark">
21
+ ~~No need to configure endpoints, manage SSL, or handle retries—we do it all.~~
22
+ </Card>
23
+
24
+ <Card title="Unified event format" icon="fa-solid fa-layer-group">
25
+ ~~Consistent event structure across all services for easier processing.~~
26
+ </Card>
27
+
28
+ <Card title="Built-in filtering" icon="fa-solid fa-filter">
29
+ ~~Filter events by type, user, or custom criteria before they reach your app.~~
30
+ </Card>
31
+</CardGroup>
32
+
33
+## ~~How it works~~
34
+
35
+<CodeGroup>
36
+```python Python
37
+from composio import Composio
38
+
39
+composio = Composio(api_key="YOUR_API_KEY")
40
+
41
+# Set up a trigger for GitHub push events
42
+trigger = composio.triggers.subscribe(
43
+ user_id="user-123",
44
+ trigger_name="GITHUB_PUSH_EVENT",
45
+ config={
46
+ "repository": "my-repo",
47
+ "branch": "main"
48
+ }
49
+)
50
+
51
+# Handle incoming events
52
+@trigger.on_event
53
+def handle_push(event):
54
+ print(f"New commit: {event['commit_message']}")
55
+
56
+ # Automatically create a deployment
57
+ composio.tools.execute(
58
+ "VERCEL_CREATE_DEPLOYMENT",
59
+ user_id="user-123",
60
+ arguments={
61
+ "repo": event["repository"],
62
+ "branch": event["branch"]
63
+ }
64
+ )
65
+```
66
+
67
+```typescript TypeScript
68
+import { Composio } from '@composio/core';
69
+
70
+const composio = new Composio({ apiKey: 'YOUR_API_KEY' });
71
+
72
+// Set up a trigger for GitHub push events
73
+const trigger = await composio.triggers.subscribe({
74
+ userId: 'user-123',
75
+ triggerName: 'GITHUB_PUSH_EVENT',
76
+ config: {
77
+ repository: 'my-repo',
78
+ branch: 'main'
79
+ }
80
+});
81
+
82
+// Handle incoming events
83
+trigger.onEvent((event) => {
84
+ console.log(`New commit: ${event.commit_message}`);
85
+
86
+ // Automatically create a deployment
87
+ composio.tools.execute('VERCEL_CREATE_DEPLOYMENT', {
88
+ userId: 'user-123',
89
+ arguments: {
90
+ repo: event.repository,
91
+ branch: event.branch
92
+ }
93
+ });
94
+});
95
+```
96
+</CodeGroup>
97
+
98
+## ~~Popular triggers~~
99
+
100
+<CardGroup cols={4}>
101
+ <Card title="GitHub" icon="fa-brands fa-github">
102
+ ~~Push, PR, issue, release, star events~~
103
+ </Card>
104
+
105
+ <Card title="Slack" icon="fa-brands fa-slack">
106
+ ~~Message, reaction, channel, member events~~
107
+ </Card>
108
+
109
+ <Card title="Gmail" icon="fa-solid fa-envelope">
110
+ ~~New email, label change, attachment events~~
111
+ </Card>
112
+
113
+ <Card title="Calendar" icon="fa-solid fa-calendar">
114
+ ~~Event created, updated, reminder events~~
115
+ </Card>
116
+
117
+ <Card title="Stripe" icon="fa-brands fa-stripe">
118
+ ~~Payment, subscription, invoice events~~
119
+ </Card>
120
+
121
+ <Card title="Jira" icon="fa-brands fa-jira">
122
+ ~~Issue created, status change, sprint events~~
123
+ </Card>
124
+
125
+ <Card title="HubSpot" icon="fa-solid fa-h">
126
+ ~~Contact, deal, ticket activity events~~
127
+ </Card>
128
+
129
+ <Card title="Discord" icon="fa-brands fa-discord">
130
+ ~~Message, reaction, member join events~~
131
+ </Card>
132
+</CardGroup>
133
+
134
+## ~~Use cases~~
135
+
136
+### ~~Automated DevOps~~
137
+~~Trigger deployments on GitHub pushes, create Jira tickets from Sentry errors, and send Slack notifications for critical alerts—all automatically.~~
138
+
139
+### ~~Customer success automation~~
140
+~~React to support tickets, customer emails, and chat messages to automatically update CRM records and trigger follow-up actions.~~
141
+
142
+### ~~Content workflow automation~~
143
+~~Publish blog posts when documents are approved, cross-post to social media on content updates, and trigger translations for new content.~~
144
+
145
+### ~~Sales pipeline automation~~
146
+~~Update deal stages based on email interactions, schedule follow-ups from calendar events, and sync activity across all sales tools.~~
147
+
148
+## ~~Event types~~
149
+
150
+<AccordionGroup>
151
+ <Accordion title="Repository events">
152
+ ~~Push, pull request, issue, release, star, fork, branch creation/deletion~~
153
+ </Accordion>
154
+
155
+ <Accordion title="Communication events">
156
+ ~~Message sent/received, channel created, member joined, reaction added~~
157
+ </Accordion>
158
+
159
+ <Accordion title="Document events">
160
+ ~~File created/updated, page edited, comment added, permission changed~~
161
+ </Accordion>
162
+
163
+ <Accordion title="Calendar events">
164
+ ~~Event created/updated/deleted, attendee response, reminder triggered~~
165
+ </Accordion>
166
+
167
+ <Accordion title="Payment events">
168
+ ~~Payment succeeded/failed, subscription created/cancelled, invoice paid~~
169
+ </Accordion>
170
+
171
+ <Accordion title="Workflow events">
172
+ ~~Task created/completed, status changed, assignee updated, due date changed~~
173
+ </Accordion>
174
+</AccordionGroup>
175
+
176
+## ~~Advanced features~~
177
+
178
+<CardGroup cols={3}>
179
+ <Card title="Event filtering" icon="fa-solid fa-filter">
180
+ ~~Filter events before they reach your app to reduce noise~~
181
+ </Card>
182
+
183
+ <Card title="Batch processing" icon="fa-solid fa-layer-group">
184
+ ~~Group related events for efficient bulk processing~~
185
+ </Card>
186
+
187
+ <Card title="Replay events" icon="fa-solid fa-clock-rotate-left">
188
+ ~~Replay historical events for testing or recovery~~
189
+ </Card>
190
+</CardGroup>
191
+
192
+## ~~Reliability guarantees~~
193
+
194
+<CardGroup cols={2}>
195
+ <Card title="At-least-once delivery" icon="fa-solid fa-check-double">
196
+ ~~Every event is guaranteed to be delivered at least once~~
197
+ </Card>
198
+
199
+ <Card title="Automatic retries" icon="fa-solid fa-rotate">
200
+ ~~Failed deliveries are automatically retried with exponential backoff~~
201
+ </Card>
202
+
203
+ <Card title="Event ordering" icon="fa-solid fa-arrow-down-1-9">
204
+ ~~Events from the same source maintain their chronological order~~
205
+ </Card>
206
+
207
+ <Card title="Idempotency" icon="fa-solid fa-fingerprint">
208
+ ~~Each event has a unique ID to prevent duplicate processing~~
209
+ </Card>
210
+</CardGroup>
211
+
212
+## ~~Get started~~
213
+
214
+<CardGroup cols={2}>
215
+ <Card
216
+ title="Using triggers"
217
+ icon="fa-solid fa-bolt"
218
+ href="/docs/using-triggers"
219
+ >
220
+ ~~Learn how to subscribe to and handle trigger events~~
221
+ </Card>
222
+
223
+ <Card
224
+ title="Available triggers"
225
+ icon="fa-solid fa-list"
226
+ href="/toolkits/introduction"
227
+ >
228
+ ~~Browse all available triggers by toolkit~~
229
+ </Card>
230
+
231
+ <Card
232
+ title="Event-driven workflows"
233
+ icon="fa-solid fa-diagram-project"
234
+ href="/examples/slack-summariser"
235
+ >
236
+ ~~See real examples of trigger-based automations~~
237
+ </Card>
238
+
239
+ <Card
240
+ title="Troubleshooting"
241
+ icon="fa-solid fa-wrench"
242
+ href="/docs/troubleshooting/triggers"
243
+ >
244
+ ~~Debug common trigger issues and solutions~~
245
+ </Card>
246
+</CardGroup>
\ No newline at end of file