@devries-cameron20 / composio-1 / commits / 562452e31
Fork 0

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(creating-triggers): drop Step 5 (confirm verified_at), keep field as inspection note

Step 5 ("Confirm the endpoint is verified" by GETting and checking verified_at) wasn't in the V2 changelog walkthrough. The changelog goes from "point provider dashboard at URL" straight to "create V2 trigger instances" — the trigger create call is itself the natural confirmation, since it'll fail if the endpoint didn't verify. Verified in the changelog: `verified_at` IS a real field returned by GET /api/v3.1/webhook_endpoints/{id} (changelog line 44 lists the endpoint as "Get a single endpoint, including verified_at"). So the field exists; just the standalone confirmation step doesn't. - Step 4's last sentence now ends with the natural next-action ("Once the provider saves the URL, retry the trigger creation call from Using the SDK") instead of a separate Step 5. - Add a GET-by-id example to "Updating an endpoint" so verified_at remains discoverable as an inspection tool when needed, just not promoted to a mandatory step. Walkthrough collapses to 4 steps, matching the changelog structure. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Anshu Garg committed May 7, 2026 at 21:05 UTC 562452e31887640b5f82b5f4f12797106ef5a87f
1 file changed +8 -10
docs/content/docs/setting-up-triggers/creating-triggers.mdx
+8 -10
@@ -216,16 +216,7 @@ Paste the `webhook_url` from step 2 into the provider's app dashboard:
216 - **Slack** → Event Subscriptions → Request URL
217 - **Notion** → Webhook Endpoints (in the integration's settings)
218
219 -Composio responds to the provider's verification challenge automatically (Slack `url_verification`, Notion's verification token, and so on) — you don't write any handshake code on your side.
220 -
221 -### Step 5: Confirm the endpoint is verified
222 -
223 -```bash
224 -curl "https://backend.composio.dev/api/v3.1/webhook_endpoints/<ENDPOINT_ID>" \
225 - -H "x-api-key: <YOUR_COMPOSIO_API_KEY>"
226 -```
227 -
228 -A populated `verified_at` timestamp on the response means the provider has completed the handshake. You can now retry the trigger creation call from [Using the SDK](#using-the-sdk).
219 +Composio responds to the provider's verification challenge automatically (Slack `url_verification`, Notion's verification token, and so on) — you don't write any handshake code on your side. Once the provider saves the URL, retry the trigger creation call from [Using the SDK](#using-the-sdk).
220
221 ### Updating an endpoint
222
@@ -249,6 +240,13 @@ curl -X POST "https://backend.composio.dev/api/v3.1/webhook_endpoints/<ENDPOINT_
240
241 The `webhook_url` is immutable for the lifetime of the endpoint — rotating the signing secret on the provider side is a `PATCH` on the existing endpoint, not a new one.
242
243 +To inspect a single endpoint (handy for checking `verified_at` after a provider re-save):
244 +
245 +```bash
246 +curl "https://backend.composio.dev/api/v3.1/webhook_endpoints/<ENDPOINT_ID>" \
247 + -H "x-api-key: <YOUR_COMPOSIO_API_KEY>"
248 +```
249 +
250 To list every endpoint in the current project:
251
252 ```bash