Register Geo-trigger Webhooks to receive real-time Entry/Exit notifications from your customers.
Configure a Geo-trigger Webhook
From the Canvas Integration section, add a new Webhook and select Geo-trigger as the type in the dropdown.

Additional Header and Body fields
You can have additional information in either the headers or the body of the webhook’s request by adding extra fields.

You can also configure a Geo-trigger Webhook through Config API (Information on using the Config API for registering a Webhook can be found here.)
If you’d like to Create a Destination using Config API, you’ll use the following /Endpoints;
Endpoint |
Description |
Add Geo-trigger Webhooks to a Project |
When creating or editing a Project you can add Geo-trigger Webhooks within the webhooks property.
Set the type to trigger in the request.
Endpoint: https://config.bluedot.io/prod1/projects
Example of adding a Geo-trigger Webhook:
"webhooks": [{
"type": "trigger",
"url": "<webhook URL goes here>"
}]
|
Webhook request JSON structure
Entry JSON request |
{
"type": "checkIn",
"checkInId":"73cbdf0c-5523-46ec-bc15-c9ad362b2a85",
"installRef":"c92f4a32dc35282d4471b42993f809fa",
"checkInTime": "02-09-2018 00:08:16",
"checkInTimeISO": "2018-09-02T00:08:16.000Z",
"longitude":144.98173087835312,
"latitude":-37.819805462370944,
"fenceName":"Melbourne Cricket Ground Gate 1",
"deviceSpeed":10,
"fenceId":"80fc36ad-ee72-4450-ad96-b3fadfc26cb4",
"zoneName":"Melbourne Cricket Ground",
"zoneId":"ffece0a9-fd21-4148-892e-0a61d01a6bd4",
"deviceType":"iPhone 9,3",
"sdkVersion": "1.13.0",
"os": "iOS",
"osVersion": "12.1.2",
"appBuildVersion": "2.8.0.639",
"receivedAt": "2018-09-02T00:22:43.816Z"
}
|
Entry JSON request with customEventMetaData and customData |
{
"type": "checkIn",
"checkInId":"73cbdf0c-5523-46ec-bc15-c9ad362b2a85",
"installRef":"c92f4a32dc35282d4471b42993f809fa",
"checkInTime": “02-09-2018 00:08:16",
"checkInTimeISO": "2018-09-02T00:08:16.000Z",
"longitude":144.98173087835312,
"latitude":-37.819805462370944,
"fenceName":"Melbourne Cricket Ground Gate 1",
"deviceSpeed":10,
"fenceId":"80fc36ad-ee72-4450-ad96-b3fadfc26cb4",
"zoneName":"Melbourne Cricket Ground",
"zoneId":"ffece0a9-fd21-4148-892e-0a61d01a6bd4",
"deviceType":"iPhone 9,3",
"sdkVersion": "1.13.0",
"appBuildVersion": "2.8.0.639",
"os": "iOS",
"osVersion": "12.1.2",
"receivedAt": "2018-09-02T00:22:43.816Z",
"zoneCustomData": {
"key1": "value1",
"key2": "value2"
},
"eventMetaData": {
"eKey1": "eValue1"
}
}
|
Exit JSON request |
{
"type": "checkOut",
"checkInId":"73cbdf0c-5523-46ec-bc15-c9ad362b2a85",
"installRef":"c92f4a32dc35282d4471b42993f809fa",
"checkInTime": "02-09-2016 00:08:16",
"checkInTimeISO": "2016-09-02T00:08:16.000Z",
"checkOutTime": "02-09-2016 02:25:47",
"checkOutTimeISO": "2016-09-02T02:25:47.000Z",
"dwellTime": 138,
"fenceName":"Melbourne Cricket Ground Gate 1",
"fenceId":"80fc36ad-ee72-4450-ad96-b3fadfc26cb4",
"zoneName":"Melbourne Cricket Ground",
"zoneId":"ffece0a9-fd21-4148-892e-0a61d01a6bd4",
"deviceType":"iPhone",
"sdkVersion": "1.8.0",
"appBuildVersion": "2.8.0.639",
"receivedAt": "2016-09-02T02:25:47.816Z"
}
|
Exit JSON request with customEventMetaData and customData |
{
"type": "checkOut",
"checkInId":"73cbdf0c-5523-46ec-bc15-c9ad362b2a85",
"installRef":"c92f4a32dc35282d4471b42993f809fa",
"checkInTime": "02-09-2016 00:08:16",
"checkInTimeISO": “2016-09-02T00:08:16.000Z",
"checkOutTime": "02-09-2016 02:25:47",
"checkOutTimeISO": "2016-09-02T02:25:47.000Z",
"dwellTime": 138,
"fenceName":"Melbourne Cricket Ground Gate 1",
"fenceId":"80fc36ad-ee72-4450-ad96-b3fadfc26cb4",
"zoneName":"Melbourne Cricket Ground",
"zoneId":"ffece0a9-fd21-4148-892e-0a61d01a6bd4",
"deviceType":"iPhone",
"sdkVersion": "1.8.0",
"appBuildVersion": "2.8.0.639",
"receivedAt": "2016-09-02T02:25:47.816Z",
"zoneCustomData": {
"key1": "value1",
"key2": "value2"
},
"eventMetaData": {
"eKey1": "eValue1"
}
}
|
Geo-trigger Webhook field description
Fields returned in Check-in event JSON request
Fields returned in Check-out event JSON request