How do I manage webhooks?

Webhooks are a tool for sending information from EventHQ to other computer systems in real time. They allow you to register an URL where the information will be sent in JSON format. Webhooks are triggered at specific points of interest in the booking lifecycle such as:

  • A new attendee is created
  • An attendee status is changed (e.g. to complete or cancelled)
  • A new transaction is created
  • An existing transaction status is changed to complete
  • A new order is created
  • An order status is changed (e.g. to payment due or complete)
  • An automatic email sent by EventHQ is not delivered (bounces)

Webhooks are an extremely powerful tool for integrating EventHQ with your existing databases. If you'd like to explore how to send data to your existing software (e.g. CRM, mailing list etc) then either check the EventHQ App store (via your admin area) or get in touch with us at support@eventhq.co.uk.

Settings / Notifications

Settings / Notifications

To create a webhook, go to the "Webhooks" section and click the "Create new webhook" button

To create a webhook, go to the "Webhooks" section and click the "Create new webhook" button

A new modal window will open up with a form for your webhook details

Complete the form and click the "Create webhook" button

  • Select the point of interest in the booking lifecycle when this particular webhook should be sent
  • Enter the complete URI where the data will be sent. This can be either http:// or https://
Complete the form and click the "Create webhook" button

The new webhook will be listed in the Webhooks section

The new webhook will be listed in the Webhooks section

You can send a test webhook to your URL by clicking the "send test webhook" button

  • Webhooks are fired in batches at approximately 5 minute intervals
  • Your URL must respond with a 200 HTTP header code otherwise EventHQ will assume the webhook failed. If a webhook fails, EventHQ will try again at steadily increasing intervals until the webhook is either successfully sent or the webhook fails to send 10 times
  • You can check that the webhook is genuine by checking the private key provided in the Webhooks section matches the SHA256 encoded key in the Http-X-EventhQ-Hmax-Sha256 header
You can send a test webhook to your URL by clicking the "send test webhook" button

The resulting webhook payload looks like this:

You can delete an existing webhook by clicking the trash icon next to it

You can delete an existing webhook by clicking the trash icon next to it

Then confirm you really want to delete the webhook

Then confirm you really want to delete the webhook

Still need help? Contact Us Contact Us