Create a new geofence

post

https://dev-api.lifeknight.ai/api/v2/geofences

Creates a new geofence for the authenticated user (or target user_id).

Circle type requires center_latitude, center_longitude, and radius.
Polygon type requires coordinates array with a minimum of 3 points.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

user_id

integer

User ID to create geofence for (defaults to authenticated user)

name

string

required

length ≤ 255

Name of the geofence

description

string

Description of the geofence

type

string

enum

required

Type of geofence

Allowed:

center_latitude

float

-90 to 90

Center latitude (required for circle type)

center_longitude

float

-180 to 180

Center longitude (required for circle type)

radius

integer

1 to 100000

Radius in meters (required for circle type, 1m to 100km)

coordinates

array of objects

Coordinate points (required for polygon, min 3). Each point accepts either {latitude, longitude} or {lat, lng} keys.

coordinates

address

string

length ≤ 255

city

string

length ≤ 100

state

string

length ≤ 100

zipcode

string

length ≤ 20

country

string

length ≤ 100

notify_on_enter

boolean

Defaults to true

Send notification when entering geofence

notify_on_exit

boolean

Defaults to true

Send notification when exiting geofence

status

string

enum

Defaults to active

Status of the geofence

Allowed:

color

string

length ≤ 7

Defaults to #3388ff

Display color in hex format (e.g.,

Responses

200

Validation error

401

Unauthorized - Invalid or expired token

403

Unauthorized - Cannot create geofences for this user

Language

Credentials

Bearer

JWT

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

201Geofence created successfully