Geofence In Event

Overview

Geofence in event gets triggered when the tracker enters a designated geofenced area.

Create geofence in event

This endpoint allows you to add a geofence in event to a tracker. When the event is triggered, notifications are sent to recipients based on the event notification configuration.

POST {baseUrl}/tracker/event

Request Body

Field	Type	Required	Description
trackerId	string	✅	The unique ID of the tracker.
eventType	string	✅	The type of event to be created. (For geofence in event, use "GEOFENCE_IN")
geofenceIds	array	✅	Array of geofence ids. Instructions on how to create a geofence can be found here
eventNotification	object	❌	Optional notification settings for the event.
eventNotification.acceptedMediums	array	❌	A list of notification channels and their settings.
eventNotification.status	string	❌	Status of the notification configuration. Accepts either "inactive" or "active"

Sample Success Data

//Sample Request Body
{
    "trackerId": "6780092e89b7bd4c6b0a82be",
    "eventType": "GEOFENCE_IN",
    "geofenceIds": [ "67ceebdba95c9d18a4c39333" ],
    "eventNotification": { //optional
      "acceptedMediums": [
        {
          "channel": "email",
          "isEnabled": true,
          "defaultEmail": [ "[e-mail]" ]
        },
        {
          "channel": "sms",
          "isEnabled": true,
          "defaultPhone": [ "[phone]" ]
        },
        {
          "channel": "inApp",
          "isEnabled": false
        }
      ],
      "status": "active"
    }
}

Sample Success Response

//Sample success response
{
    "status": true,
    "message": "Tracker event successfully created",
    "data": {}
}