---
title: "Create a session"
method: POST
path: "/auth/"
tags: ["sessions"]
---

# Create a session

`POST /auth/`

Creates a new partial-import session and mints the initial hydration token to pass to the widget. Requires your **backend** license key — never call this client-side.

## Request body

- SessionCreate
  - `import_identifier` string — A label for your own bookkeeping (e.g. schema name, import type). Not used for lookups. Defaults to "".
  - `expires_in` integer — Hydration token TTL in seconds. Defaults to 21600 (6 hours).

## Response `201`

Session created

- SessionCreated
  - `sessionId` string, uuid — Backend session identifier. Persist this durably — needed to resume the session or delete it later.
  - `hydrationId` string — Short-lived access token. Pass this to the widget to start or resume the session.
  - `expiresIn` integer — Seconds until the hydrationId expires.
  - `savedAt` string, date-time

---

[API](https://skmtc.dev/dromoio/apis/dromo-sessions-api.md) · [All operations](https://skmtc.dev/dromoio/apis/dromo-sessions-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dromoio/dromo-sessions-api/revisions/2f83276bf0f0/schema)