Skip to content
First requestVisit website ↗
Navigation

One location reading while a checked-in Sales Coach visit is open

Sent by the rep's phone about every 2 minutes after a VERIFIED check-in, until the response says stop_tracking. Uses the same 150 m / 100 m accuracy rule as check-in. Two readings in a row outside the circle record a departure (at the first one). Leaving before the workspace minimum emails managers "Left early" and returns ask_leave_reason; staying past the maximum emails "Running long". Only the distance is stored, never the phone's coordinates. Flag-gated with check-in (FIELD_SALES_GEOFENCED_CHECKIN).

POST
https://api.channelautomation.com/api/field-sales/appointments/{id}/presence

Authorization

  • BearerAuth
    HTTP Bearer (JWT)
    required

Path parameters

  • id
    string
    required
    format: uuid

Request body JSON required

  • latitude
    number
    required
  • longitude
    number
    required
  • accuracy_meters
    number
    required
  • captured_at
    string
    required
    format: date-time

Returns

200

{ success, presence: { state, distance_meters, minutes_on_site, departed_at, left_early, ask_leave_reason, running_long, next_visit_at?, stop_tracking, next_reading_seconds } }

409

No verified check-in for this visit, or the visit window has closed — { stop_tracking: true }

Type to search…

↑↓ navigate↵ selectEsc close