---
title: "Start a new session"
method: POST
path: "/{version}/integrations/{integration_id}/sessions"
tags: ["Session Management"]
---

# Start a new session

`POST /{version}/integrations/{integration_id}/sessions`

Public endpoint. Requires integration API key in `api-key` header.

## Path parameters

- `version` 'v1', required
- `integration_id` string, required

## Request body

- CreateSessionRequest
  - `client_reference_id` string — Caller-side correlation id

## Response `201`

Session created

- Session
  - `id` string, required
  - `integration_id` string, required
  - `state` 'active' | 'processing' | 'processed' | 'failed' | 'discard' | 'expired', required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time
  - `expires_at` string, date-time, required
  - `inactivity_timeout_seconds` integer
  - `accepted_records_total` integer
  - `accepted_records_by_entity` object
  - `last_error` string, nullable

## Other responses

- `401` — Unauthorized
- `429` — Too Many Requests

---

[API](https://skmtc.dev/sprinto/apis/sprinto-custom-integration-entities-sync-api.md) · [All operations](https://skmtc.dev/sprinto/apis/sprinto-custom-integration-entities-sync-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sprinto/sprinto-custom-integration-entities-sync-api/revisions/270aadbb0f41/schema)