---
title: "Get Embedded SDK token"
method: POST
path: "/embed/sessions"
tags: ["Embed Sessions"]
---

# Get Embedded SDK token

`POST /embed/sessions`

Retrieve a `token` to authenticate an `employer` or `employee` with the Kota Embedded SDK.

## Request body

- CreateSessionTokenRequest
  - `employer_id` string, required
  - `employee_id` string, nullable
  - `external_customer_id` string, nullable — A unique identifier assigned by the Employer of Record (EoR) platform to the Customer (i.e. the company using the EoR service) for which the employee is employed. This ID groups employees under this Customer, enabling the aggregation of contribution reporting and other values per Customer rather than per legal entity. This parameter is required for Employer Session tokens for EoR platforms.

## Response `200`

OK

- CreateSessionTokenResponse
  - `token` string, required
  - `expiry` string, date-time, required

## Other responses

- `400` — Bad Request
- `404` — Not Found

---

[API](https://skmtc.net/kota/apis/kota-api.md) · [All operations](https://skmtc.net/kota/apis/kota-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kota/kota-api/versions/7b8b3ed87c96/schema)