Using Webhooks on InEvent - API

In this article, we will guide you through the steps to use Webhooks on the InEvent platform within the API space. Webhooks allow you to automate certain processes, such as sending data to external systems or triggering custom actions based on events within the platform.

What are Webhooks?

A Webhook is a mechanism that allows an application to send real-time information to other applications or services. It is essentially a URL that a third-party system can use to receive automated updates whenever an event occurs in another system. These updates contain information about the event that occurred, such as a new user registration or a ticket purchase.

Using Webhooks on InEvent

InEvent provides Webhook functionalities, which allow you to receive real-time notifications when certain events occur on the platform. For example, you can receive a webhook notification when someone enrolls or unenrolls from an activity in your event. You can also use these webhooks to trigger actions in other systems or to update your own internal systems.

InEvent webhook calls are made from dynamic IPs.

Getting Started

To use Webhooks on InEvent, you will need to create a Webhook endpoint. A Webhook endpoint is a URL that InEvent will send your Webhook updates to.

Instructions for creating Webhook endpoints may vary depending on the type of application you are using. To learn how to create webhook endpoints, consult your application developer documentation.

After creating your Webhook endpoint (or URL), complete the following steps to integrate the Webhook with InEvent:

  1. Log in to your InEvent account.
  2. Click on the API symbol (</>) at the bottom right corner of your screen.
  3. Choose the Webhook option from the left panel.
Gif showing how to navigate to Webhooks from API
Webhooks can also be accessed and created at the event level in the Settings > Integrations > Webhooks page, and at the company level in the Integrations > Webhooks page. It's important to note that actions taken on the API page will be mirrored in the respective Webhooks Integration pages and the same applies in reverse.

Adding a Webhook to InEvent

You can add webhook events at the company level and event level.

To add a Webhook to the platform, you can use the webhook.create method. This method takes in the Webhook endpoint URL and the request type as arguments.

Click here, to see the list of request types supported by the platform. The requests are to be written in the format below:

request type format

To add a new Webhook to the platform, complete the following steps:

  1. Click on the beaker icon next to webhook.create.
  2. Enter your companyID or eventID
  • For adding a company-level webhook, type companyID= and enter the company's ID in the GET field.
  • For adding an event-level webhook, type eventID= and enter the event's ID. Then, type companyID= and enter the company's ID in the GET field.
  1. Enter the request type in the type field.
  2. Enter your Webhook endpoint URL in the url field.
  3. Press the Enter button on your keyboard.
A Gif showing how to add a webhook from the webhook.create

Ensure to add a correct webhook request type supported by the platform. If the webhook request created is invalid, you will see the 406 error below:
402 error

Editing a webhook

After creating a webhook you can change its request type using the webhook.edit method. To do this, complete the following steps:

  1. Click on the beaker icon next to webhook.find
  2. Enter your webhookID.
  3. Enter type in the Key field.
  4. Type in value= and enter the new webhook request under the POST field.
  5. Press the Enter button on your keyboard and the changes will be reflected.

Editing webhooks

Finding a previously added Webhook

To find a previously added webhook, complete the following steps:

  1. Click on the beaker icon next to the webhook.find method.
  2. Enter either your companyID or eventID.

Gif showing the webhook.find and where to spot the ID and how to use it to see the new actions

For each webhook, when using the webhook.find method, you will receive the following information in JSON format:

  • WebhookID: This is the unique ID automatically assigned to the webhook by the platform.
  • eventID: Your event's ID (automatically assigned by the platform).
  • Company ID: Your company's ID.
If you are searching for company-level webhooks, the event's ID will not be provided.
  • type: This field indicates the type of the webhook request.
  • url: The webhook endpoint URL.
  • date: This field represents the date when the webhook was created, stored as a timestamp in string format.

Removing a Webhook from InEvent

To remove a Webhook from the platform, complete the following steps:

  1. Click on the beaker icon next to the webhook.remove method.
  2. Enter the WebhookID of the webhook you would like to remove into the WebhookID field.
To obtain your WebhookID, you can find it under the list of previously added webhooks and copy the WebhookID from the json response.
  1. Press the Enter button on your keyboard.
Gif showing how to remove a previously created webhook

Checking Webhook Request and Response examples

To test your Webhooks, InEvent provides options for you to see examples of your Webhook requests and responses. The webhook.requestExample and webhook.responseExample methods allow you to see what your Webhook request and responses will look like in json format.

Both the webhook.requestExample and webhook.responseExample methods take the WebhookID as an argument.

To see your Webhook request and response examples, complete the following steps:

  1. Click the beaker icon next to any of the methods (depending on your use case).
  2. Enter the WebhookID into the WebhookID field.
To obtain your WebhookID, use the webhook.find method and copy the WebhookID from the json response.
  1. Press the Enter button on your keyboard.
Gif showing webhook.example  and how to see the ID number from webhook.find and insert it to  in webhook.example to see an actual example

Once you have successfully added your Webhook endpoint URL to the platform, InEvent will automatically send updates to it whenever an event occurs that triggers the Webhook. The updates will contain information about the event, such as the ID of the attendee who registered and the ID of the event that the attendee registered for.

Viewing Webhook logs

Once a webhook event has been triggered, the information will appear in the webhook.find.log method.

To see the logs, complete the following steps:

  1. Click on Log at the left menu of the page.
  2. Click on the beaker icon next to the webhook.find.log method.
  3. Enter your company ID or eventID.

A list of the webhook events that have been triggered will be displayed.

Viewing webhook logs

How Did We Do?