> For the complete documentation index, see [llms.txt](https://docs.sendstackhq.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sendstackhq.com/live-tracking-apis/events/create-events/geofence-in-event.md).

# 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.

<mark style="color:green;">`POST`</mark> `{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](/live-tracking-apis/geofences/create-geofence.md) |
| `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": [ "test@gmail.com" ]
        },
        {
          "channel": "sms",
          "isEnabled": true,
          "defaultPhone": [ "+2349088888888" ]
        },
        {
          "channel": "inApp",
          "isEnabled": false
        }
      ],
      "status": "active"
    }
}
```

#### Sample Success Response

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