Get Embedded SDK token | Kota Embed Documentation

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

Authentication

AuthorizationBearer

Authorization header using the Bearer scheme

Request

This endpoint expects an object.

employer_idstringRequiredformat: "er_.+"

employee_idstring or nullOptionalformat: "ee_.+"

external_customer_idstring or nullOptional

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

tokenstring

expirystringformat: "date-time"

1	import requests
2
3	url = "https://test.api.kota.io/embed/sessions"
4
5	payload = { "employer_id": "er_3b1333d87d9d4fd6ad83ba7f6b0e951a" }
6	headers = {
7	"Authorization": "Bearer <token>",
8	"Content-Type": "application/json"
9	}
10
11	response = requests.post(url, json=payload, headers=headers)
12
13	print(response.json())

Authentication

Request

Response

Errors