---
title: "Create"
method: POST
path: "/tracking/sessions/create_session/v1"
tags: ["/tracking"]
---

# Create

`POST /tracking/sessions/create_session/v1`

Creates a tracking session with ordered geofences or an organization template and links its device. | auth: api_key | authz: min_org_role=operator | (SessionsCreateV1Req) -> (PydanticObjectId)

## Query parameters

- `device_id` string, required
- `no_auto_termination` boolean

## Request body

- SessionsCreateV1Req
  - `schema_version` 2, required
  - `off_chrt_reference_id` string, nullable — Must be a URL-safe string of 1-64 characters. Allowed characters: A-Z, a-z, 0-9, '.', '_', '~', '-' (RFC 3986 unreserved).
  - `comments` string, nullable
  - `public` boolean
  - `off_chrt_shipper_org_data_id` string, nullable
  - `termination_scheduled_for_timestamp` string, date-time, nullable
  - `geofences` SessionGeofenceClientCreate1[] — unresolved $ref
  - `geofence_template_id` string, nullable

## Response `200`

Successful Response

- string

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/chrt/apis/chrt-fastapi.md) · [All operations](https://skmtc.dev/chrt/apis/chrt-fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/chrt/chrt-fastapi/revisions/ea04e157edb3/schema)