> ## Documentation Index
> Fetch the complete documentation index at: https://docs.withflex.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Legacy Webhooks Deprecation

> Migrate from legacy webhooks to our new webhook system by September 1, 2025.

<Warning>
  **Important:** We're deprecating legacy webhooks on September 1, 2025. To avoid service disruptions, please migrate to our new webhook system before this date.
</Warning>

## Why we're making this change

To improve reliability, consistency, and future scalability, we've introduced a new webhook system in the Flex dashboard. The new system provides:

* Improved delivery reliability
* Consistent event payload structures
* Enhanced monitoring and debugging tools
* Support for more event types and filtering options

## Migration timeline

| Date                  | Milestone                                             |
| :-------------------- | :---------------------------------------------------- |
| **June 30, 2025**     | Legacy webhook deprecation announcement               |
| **September 1, 2025** | Legacy webhook endpoints will be removed from the API |

## How to migrate

Follow these steps to transfer your existing webhooks to the new system:

<div className="mx-auto w-full rounded-xl overflow-hidden relative mt-6 mb-6" style={{ paddingTop: '56.25%' }}>
  <iframe className="absolute top-0 left-0 w-full h-full" src="https://www.youtube.com/embed/PGT75KV3rJM?si=JMiLZi7JeE9E6wfl" title="YouTube video player" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />
</div>

<Steps titleSize="h3">
  <Step title="Access legacy webhooks">
    Visit the [Legacy Webhooks](https://dashboard.withflex.com/webhooks) page in the Flex dashboard to view your existing webhooks.
  </Step>

  <Step title="Document your current setup">
    Make note of the endpoint URL and subscribed events for each legacy webhook.
  </Step>

  <Step title="Navigate to the new webhooks page">
    Go to the [Webhooks & Events](https://dashboard.withflex.com/webhooks/manage) page in the dashboard to begin recreating your webhooks.
  </Step>

  <Step title="Recreate each webhook">
    For each legacy webhook, create a new webhook using the same endpoint URL and event subscriptions.
  </Step>

  <Step title="Test and verify">
    Once your new webhooks are set up, test them to ensure events are being received correctly.
  </Step>

  <Step title="Remove legacy webhooks">
    After confirming your new webhooks are working properly, you must delete your legacy webhooks to avoid receiving duplicate events.

    <Warning>
      **Important:** If you don't delete your legacy webhooks after migrating, your system will receive duplicate events which may cause issues with your integration.
    </Warning>
  </Step>
</Steps>

## Key differences to be aware of

The new webhook system is highly compatible with the legacy system. The only significant change is:

* **Signature verification:** The new system uses a different signature method

There are no changes to event names or payload structures, ensuring a smooth transition.

## Need help?

If you have any questions or need assistance with migrating your webhooks, please contact us at [support@withflex.com](mailto:support@withflex.com).