---
title: "Create Geofence Subscription"
method: POST
path: "/v2/organisations/{organisation_id}/geofence/subscription/create"
tags: ["Gateway GRPC"]
---

# Create Geofence Subscription

`POST /v2/organisations/{organisation_id}/geofence/subscription/create`

## Request

- Base URL: `https://api.cautio.in` (the document declares no server; this is the origin it was published from)
- URL: `https://api.cautio.in/v2/organisations/{organisation_id}/geofence/subscription/create`
- Auth: HTTP bearer

## Path parameters

- `organisation_id` string, required

## Request body

- CreateGeofenceSubscriptionDto
  - `geofence_name` string, required: Geofence name
  - `entity_ids` GeofenceEntityIdsDto, required
    - `sub_organisation_ids` string[]: Sub-organisation IDs
    - `vehicle_tags` string[]: Vehicle tag IDs
    - `vehicle_ids` string[]: Vehicle IDs
  - `usage` string, required: Usage context of geofence
  - `category` string, required: Geofence category
  - `events` string[], required: Events to subscribe for
  - `boundary_details` GeofenceBoundaryDetailsDto, required
    - `boundary_type` 0 | 1 | 2 | 3 | 4, required
    - `radial_boundary` GeofenceRadialBoundaryDto
      - `center` GeofenceCenterDto, required
        - `latitude` number, required: Latitude of geofence center
        - `longitude` number, required: Longitude of geofence center
      - `radius_meters` number, required: Radius in meters
    - `administrative_boundary_id` string: Administrative boundary ID
    - `polygonal_boundary` GeofencePolygonalBoundaryDto
      - `vertices` string[], required: Array of coordinates defining the polygonal boundary
    - `route_boundary` GeofenceRouteBoundaryDto
      - `route_points` string[], required: Array of coordinates defining the route points
      - `buffer_meters` number, required: Buffer radius in meters around the route
  - `status` number, required: Status of the geofence subscription
  - `frequency` GeofenceFrequencyDto
    - `day` number[], required: Days of week when the geofence subscription is active
    - `start_time` string, required: Geofence active start time
    - `end_time` string, required: Geofence active end time
    - `end_day_offset` number: Number of calendar days after the start day when activity ends

## Response `200`

Geofence Subscription created successfully

---

[API](https://skmtc.dev/cautio/apis/cautio-api.md) - [All operations](https://skmtc.dev/cautio/apis/cautio-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cautio/apis/cautio-api/revisions/214e6d1d2b6c?raw)