148
149
## Backward compatibility
150
151
-- V1 ingress (`/api/v3/trigger_instances/{toolkit}/{project_id}/handle`) is **not deprecated**.
152
-- All existing trigger slugs — every `SLACK_RECEIVE_*`, `SLACKBOT_*`, and equivalent legacy slug across toolkits — continue to route through V1 unchanged.
153
-- No server-side data migration touches existing trigger instances.
154
-- V1, V2, and V3 outbound webhook payload formats are unaffected.
151
+**Everything you have today keeps working — same URLs, same trigger slugs, same payload shapes, no data migration.**
152
156
-## Availability
153
+- The V1 ingress URL (`/api/v3/trigger_instances/{toolkit}/{project_id}/handle`) is not deprecated.
154
+- Every existing trigger slug — `SLACK_RECEIVE_*`, `SLACKBOT_*`, and the equivalent legacy slugs on other toolkits — continues to route through V1.
155
+- V1, V2, and V3 outbound webhook payload formats are unchanged.
156
+- No server-side migration touches your existing trigger instances or auth configs.
157
158
-V2 is opt-in. Slack is the first toolkit available; HubSpot, Linear, and other app-level toolkits will follow the same pattern and be announced in their own changelog entries. There is no migration deadline — adopt V2 when you need its features.
158
+You only need to set up a V2 webhook endpoint in two cases:
159
160
-## Support
160
+1. **You want to use one of the new V2 trigger slugs** (e.g. `SLACK_CHANNEL_MESSAGE_RECEIVED`, `SLACK_DIRECT_MESSAGE_RECEIVED`). A V2 endpoint is required at setup; without one, the upsert returns `400` with a `suggestedFix`.
161
+2. **You want to move an OAuth app that's currently shared across multiple projects or organizations onto V2.** Pick the project that should own it on V2 and set up an endpoint there, or register separate OAuth apps per project (see [Heads up: OAuth apps are project-scoped on V2](#heads-up-oauth-apps-are-project-scoped-on-v2)).
162
162
-- [Discord](https://discord.gg/composio)
163
-- [support@composio.dev](mailto:support@composio.dev)
163
+If neither applies to you, no action is required.