Webhooks allow external systems to send data to Gundi via HTTP POST callbacks.
Configure a Webhook Integration
Follow these steps in your source system (e.g., ChirpStack, The Things Network, Digital Matter):
1) Create the webhook
- Name: Any label (e.g., gundi-webhook)
- Format: JSON (if prompted)
2) Set the endpoint
Base URL:
https://hooks.gundiservice.org/webhooks
3) Add required headers
| Header | Value |
|---|---|
apikey |
Provided by the Gundi team |
x-gundi-integration-type |
generic_webhooks |
4) Save
Save the configuration in your source system.
Requirements
- Every data packet must include a timestamp field, preferably in ISO 8601 format, representing when the event was recorded (for example,
2023-07-27T09:34-03:00or2023-07-27T09:34Z). - Every data packet must include both a latitude field and a longitude field.
- Movement data must include a device ID or source ID field.
Integration Testing
- Trigger a sample event from your system (or wait for the next transmission).
- Confirm delivery:
- Activity logs appears in Gundi
- Data is received by the destination set up in your Gundi Connection
If your testing is unsuccessful or any steps are unclear, please contact our team for further guidance or troubleshooting.
