Enabling Webhook Notifications
Instructions for turning on and configuring webhook notifications in SimpleTix.
1. Enable Webhooks
- Log in to your SimpleTix Manager account. You can either go directly to the Advanced Options page or log in at https://manager.simpletix.com/ and click on Settings in the top rail.
- In the Settings menu, select Advanced Options from the left-hand side.
- Locate the webhook options section where you can configure both types of webhooks.
2. Configure Your Webhook URLs
- For Order Webhooks: Toggle on “Turn on the Post Order webhook feature” and enter your order notification endpoint URL.
- For Post-Scan Webhooks: Toggle on “Turn on the Post Scan webhook feature” and enter your scan notification endpoint URL.
- Each webhook URL is the endpoint on your server where SimpleTix will send POST notifications.
- Provide URLs that are capable of accepting incoming POST requests. These endpoints should be secure (using HTTPS) and able to process URL-encoded form data.
3. Webhook Types and Trigger Details
SimpleTix offers two types of webhooks that can be configured from the Advanced Options section:
Order Webhook
- When a new order is created via SimpleTix, a POST request is sent to your configured URL.
- This webhook triggers immediately after an order is successfully completed.
Sample Order Webhook Response
The Order webhook sends data in a form-encoded format (maintained for legacy and backwards compatibility):
Note the difference in formats: Order webhooks use the legacy form-encoded data format for backwards compatibility, while the newer Post-Scan webhooks use JSON. Your endpoint will need to handle the appropriate format for each webhook type.
Post-Scan Webhook (New Feature)
- Sends a POST request when a ticket is scanned using the SimpleTix Organizer app.
- This webhook triggers only for actual scans and will not fire when attendees are admitted manually through the web interface.
- Enables real-time tracking and custom actions when attendees check in at your event.
Both webhook types can be configured independently from the Advanced Options page, allowing you to send different types of notifications to different endpoints as needed.
Sample Post-Scan Webhook Response
When a ticket is scanned, you’ll receive a response like this:
This response includes the participant details, ticket information, and scan result, allowing you to trigger custom actions in your systems when attendees arrive at your event.