Skip to main content
POST
Create Geofence
Creates a geofence: a circle the Sequenzy mobile SDKs register with the phone’s location services. When a signed-in user enters, leaves or stays in it, Sequenzy records app.geofence_entered, app.geofence_exited or app.geofence_dwelled on their contact. See Geofences. Apps pick up a new geofence on their next refresh. A workspace holds at most 10,000. Requires the geofences:write scope. Unknown fields are ignored.

Request

string
required
Geofence name, up to 120 characters.
number
required
Center latitude, from -90 to 90.
number
required
Center longitude, from -180 to 180.
integer
required
Radius in meters, from 100 to 10,000. Phones trigger small regions late or not at all, so use 200 or more.
integer | null
default:"null"
Record app.geofence_dwelled once a contact has stayed inside this many seconds, from 60 to 14,400. null turns dwell off.
integer
default:"3600"
How long a repeat of the same transition by the same contact is ignored, from 300 to 604,800 seconds.
string | null
Optional group label such as stores: letters, numbers, spaces, dots, dashes and underscores, up to 64 characters. Triggers and segments can target a whole group.
string | null
Your own ID for the place, up to 128 characters and unique in your workspace. Imports match rows by it.
boolean
default:"true"
Paused geofences are not sent to apps and record nothing.

Response

Returns 201 with the geofence.
object

Errors