Webhook Event Simulation

Simulating a Webhook allows you to test how a webhook would behave for a specific event without waiting for that event to actually occur. Simulation uses the same serialization, filtering, and business logic as real webhook delivery making it useful for testing webhook configurations, debugging delivery issues, and validating your webhook endpoint before going live.

How simulating works

Webhook simulation creates a temporary webhook event that mimics the real delivery process without actually sending the request to your endpoint. The simulation:

1. Validates the webhook and event - Ensures both the webhook token and event token exist in your environment
2. Generates the payload - Creates the exact payload that would be sent, including all serialization, blocklist filtering, and API versioning
3. Applies business logic - Checks if the event is enabled for the webhook and if the payload would pass any configured filters
4. Returns the outcome - Provides one of three simulation results without actually delivering the webhook event

Simulation outcomes

The simulation will return one of three outcomes:

• Webhook would deliver - The webhook event is enabled and would be successfully delivered to your endpoint
• Webhook would skip - The webhook event is enabled but would be skipped due to configured filters not matching the payload
• Event not enabled for this webhook - The specified event type is not enabled for this webhook

How to simulate

1. Provide an event ID - Provide a valid event ID (can be found in the events tab on the left in dashboard) to simulate for your webhook
2. Click simulate - Press the simulate button below the Test Event ID text box.
3. View outcome - Check payload if webhook would deliver, the filter if the webhook would skip, or enabled events in your webhook if the event isn’t enabled.