Getting events and data from Ubiqod: using the webhook

Getting events and data from Ubiqod: using the webhook

The Ubiqod platform lets you send the data received from your trackers in real time through webhooks. In this article, you’ll learn how to set up this dispatch.
Info
The Ubiqod REST API gives you access to configuration data for trackers, badges, and sites. It provides useful information for tracker management, such as the date and time when data was last received and transmitted. This API cannot be used to retrieve events or data.
The API documentation is available here: https://api.ubiqod.com

How webhooks work

When a tracker sends data to the platform and that data is valid, the platform forwards it by making a POST request to a specified URL.
The content of this POST (the body or payload) contains all the information needed to process the data.

Payload example

You can view an example of the payload sent to the webhook destination URL here: https://storage.googleapis.com/skiply-prod-ubiqod/schemas/callbackexample_new.json

JSON schema

This schema can, for example, be used to automatically map the available fields in systems such as Microsoft Power Automate.

Webhook Configuration

To configure a webhook, go to the Dispatch menu and select Webhook under the Generic Dispatches section.

Destination URL and Header Parameters

The webhook URL defines the address (also known as the endpoint) of the system that will receive the data sent by the webhook:

Header Parameters

The header parameters are included in the request header. They can be used, for example, to add an API key, which is strongly recommended in production to prevent malicious data injection.

Data Filtering (Optional)

Filters allow you to limit the data sent by adding validity conditions to the transmitted information. This helps ensure that only relevant or valid data is forwarded to your destination system.

Other Useful Options

Compatibility Mode
This mode allows users of older versions of Ubiqod to continue receiving data in the previous format. Leave this option disabled for normal use.

Rate Limiting
This option lets you set a limit on the data transmission rate. This is useful if the destination system has its own capacity constraints.
For example, entering 3 will enforce a 3-second delay between two data transmissions.
Data will not be lost: they will be queued and sent according to the configured rate.

Missed Data Replay (IoT)
For compatible IoT devices, this option enables the platform to resend data when it detects that a previous transmission failed.

Testing and Debugging

Retry Policy on Failure

If the server receiving the webhook responds with a non-2XX status code, Ubiqod automatically retries once after 60 seconds.
If the second attempt also fails, an error is logged in the connector’s logs.
You can configure email alerts in your account settings to be notified of such failures.

Data Traceability and Logs

You can view all data sent through webhooks, along with the destination server’s responses, using the platform’s traceability features.

This section also includes details on:
  1. The retention period for technical data
  2. The ability to manually replay data in case the destination system was temporarily unavailable.

    Try Ubiqod


    Get 100 free credits to start building with Ubiqod: sign up here

      • Related Articles

      • What is Ubiqod?

        Welcome to Ubiqod – the new way to connect your field staff to your IT systems. Ubiqod provides a simple and efficient way to collect data from the field and integrate it with your preferred software, whether it's a Human Resources Information System ...

      • Adding a Ubiqod Key to your account

        To use a Ubiqod Key on the platform, it must first be added to your Ubiqod account. This step is necessary for activating and configuring the device. Accessing the Ubiqod Key section Log in to the Ubiqod interface. From the menu, go to Trackers. ...

      • How to replay missed IoT data?

        Wireless connected objects communicate using various radio protocols. Occasionally, data might get lost due to unforeseen incidents. By activating the Replay the missed data option, missed data detected by Ubiqod at the device level will be replayed ...

      • Activate your Ubiqod Key

        Introduction When you receive your Ubiqod Key, the screen is blank and the batteries are not inserted. This precaution helps prevent screen burn-in and preserves battery life during transport. Make sure to follow the steps below carefully before ...

      • What is a site in Ubiqod?

        On the Ubiqod platform, a site represents a physical location — such as a building, public area, or facility — used to group and organize trackers. Using sites is optional. If you're already using your own asset or location management system, or if ...