Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
docs(changelog): reorder Slack walkthrough — secrets first, then URL flip
Move the app-level-token step ahead of the dashboard-URL flip so all secrets (signing secret + app_token if needed) are stored before Slack starts posting events. Also drop internal mechanics from the URL-flip step (no more verified_at / url_verification jargon) — just state that Composio verifies the endpoint with Slack automatically. _(sent via Claude Code)_ Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Anshu Garg committed
Apr 18, 2026 at 21:52 UTC
450696eed827d396eed91b783330b9db8ab37c9c
1 file changed
+5
-5
docs/content/changelog/04-18-26-webhook-triggers-v2.mdx
+5
-5
@@ -87,11 +87,7 @@ curl -X PATCH "https://backend.composio.dev/api/v3/webhook_endpoints/ENDPOINT_ID
87
Store the signing secret before switching the provider's callback URL. If Slack posts to a V2 URL without a secret available, every request fails with `400` and Slack may auto-disable the endpoint after ~36 hours of failures.
88
</Callout>
89
90
-### 4. Point your Slack app at the V2 URL
91
-
92
-Set **Event Subscriptions → Request URL** in your Slack app to the `webhook_url` returned in step 2. Slack issues a `url_verification` challenge; Composio responds automatically and sets `verified_at` on the endpoint.
93
-
94
-### 5. Add an app-level token for private-scope events
90
+### 4. Add an app-level token for private-scope events
91
92
The app-level token is what lets Composio resolve per-user authorization for Slack's private-scope events.
93
@@ -109,6 +105,10 @@ curl -X PATCH "https://backend.composio.dev/api/v3/webhook_endpoints/ENDPOINT_ID
105
106
Generate the token from **Slack app → Basic Information → App-Level Tokens** with scope `authorizations:read`.
107
108
+### 5. Point your Slack app at the V2 URL
109
+
110
+Set **Event Subscriptions → Request URL** in your Slack app to the `webhook_url` returned in step 2. Composio verifies the endpoint with Slack automatically — no extra action needed on your side.
111
+
112
### 6. Create V2 trigger instances
113
114
| V1 slug (still supported) | V2 replacement | `app_token` required? |