Introduction
Webhooks provide a powerful way to stay informed about critical data updates. This feature ensures you never miss a detail when it comes to changes in People, Exhibitors, Sessions, or other event data. With real-time notifications, webhooks streamline your workflows, enhance data accuracy, and keep your systems synchronized automatically.
Benefits of Webhooks
Real-Time Data: Receive instant updates on data changes without the need for manual API requests.
Automation: Save time by automating data synchronization across systems.
Security: Protect your data with encrypted communication and HMAC verification.
Observability: Monitor only the events you care about by customizing webhook configurations.
What are webhooks?
Webhooks are automated HTTP POST notifications sent when specific events occur in Swapcard. Unlike APIs, which require you to request data manually, webhooks push updates to your system as they happen in real time.
How webhooks work?
An event occurs in Swapcard, such as the creation of a new Person, Exhibitor, or Session.
Swapcard sends an HTTP POST request to your specified URL.
The request contains detailed information about the event.
Your system processes the information in real time, keeping your data up to date.
Security Features
HTTPS Encryption: Ensures secure communication between Swapcard and your system.
HMAC Verification: A unique HMAC secret verifies the authenticity of notifications, ensuring data integrity.
How to configure webhooks?
1. Access webhooks settings
Log in to your Swapcard Studio account.
Navigate to Integration > Webhooks and click on Create a Webhook.
2. Create the webhook setup
Add a Name: Provide a descriptive name for your webhook configuration.
Select Webhook Events: Choose the events you want to monitor, such as creations or updates for People, Exhibitors, or Sessions.
Enter the URL: Specify the endpoint where Swapcard will send notifications. Ensure this URL is prepared to receive POST requests.
Set HMAC Secret: Add a hex digest secret to authenticate incoming notifications and secure your data.
3. Save your configuration
Once all fields are completed, click Create to save the webhook.
4. Update or delete Webhooks
To update an existing webhook, select it from the list in Swapcard Studio, adjust the settings, and save the changes.
To delete a webhook, access the same menu and select Delete.
Why HTTPS and HMAC are important
HTTPS Encryption
HTTPS secures the communication between Swapcard servers and your system, preventing data interception or tampering by unauthorized parties.
HMAC Verification
The HMAC hex digest secret ensures that notifications come directly from Swapcard and haven’t been altered. This acts as a digital signature, adding an extra layer of security to your webhook configuration.
Key features
Real-Time Notifications: Stay informed about changes to People, Exhibitors, and Sessions.
Customizable Configuration: Monitor only the events you need.
Secure Delivery: Ensure authenticity and encryption of notifications using HTTPS and HMAC.
Conclusion
Webhooks simplify event data management, helping you achieve seamless integration and real-time updates. Start using webhooks today and elevate your Swapcard experience!
Read More