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

# Create a new session

`POST /sessions`

Create a session (contact) in the project from the `project` header. When `userId` is supplied this is
an upsert: an existing contact with that userId is updated and returned instead of a new one being created
(one session per project + userId). Without `userId` a new guest/email session is always created.

## Headers

- `project` string, required

## Request body

- SessionDto
  - `gleapId` string — Read-only; generated by the server, ignored on create/update.
  - `gleapHash` string — Read-only; generated by the server, ignored on create/update.
  - `lang` string — Contact language. Ignored by POST /sessions for new email/guest sessions (created with "en"); settable via the SDK identify call or session update.
  - `firstActivity` unknown
  - `lastHeardFrom` unknown
  - `lastActivity` unknown
  - `lastFeedbackReport` unknown
  - `project` string
  - `organisation` string
  - `unsubscribed` boolean
  - `unsubscribedAt` unknown
  - `unsubscribeReason` string
  - `lastPageView` unknown
  - `userId` string
  - `name` string
  - `location` unknown
  - `email` string
  - `avatar` string
  - `companyId` string
  - `emailOnly` boolean
  - `companyName` string
  - `deviceType` string
  - `platform` string
  - `sla` number, double
  - `phone` string
  - `blocked` boolean
  - `plan` string
  - `value` number, double
  - `sessions` number, double — Read-only; server-maintained counter.
  - `facebookId` string
  - `instagramId` string
  - `instagramUsername` string
  - `telegramChatId` string
  - `telegramUsername` string
  - `outboundHistory` unknown
  - `countFeedbackReports` number, double
  - `countFeedbackComments` number, double
  - `tags` string[]
  - `checklistTasks` unknown
  - `customData` unknown
  - `eventData` unknown

## Response `200`

Ok

- unknown

---

[API](https://skmtc.net/gleap/apis/gleap-server.md) · [All operations](https://skmtc.net/gleap/apis/gleap-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gleap/gleap-server/versions/2bfe054193b5/schema)