---
title: "Create a Client Session"
method: POST
path: "/client_sessions/create"
tags: ["/client_sessions"]
---

# Create a Client Session

`POST /client_sessions/create`

Creates a new [client session](/core-concepts/authentication/client-session-tokens).

## Request body

- object
  - `connect_webview_ids` string[] — IDs of the [Connect Webviews](/core-concepts/connect-webviews) for which you want to create a client session.
  - `connected_account_ids` string[] — IDs of the [connected accounts](/core-concepts/connected-accounts) for which you want to create a client session.
  - `customer_id` string — Customer ID that you want to associate with the new client session.
  - `customer_key` string — Customer key that you want to associate with the new client session.
  - `expires_at` string, date-time — Date and time at which the client session should expire, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.
  - `user_identifier_key` string — Your user ID for the user for whom you want to create a client session.
  - `user_identity_id` string, uuid — ID of the [user identity](/capability-guides/mobile-access/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity) for which you want to create a client session.
  - `user_identity_ids` string[] — Deprecated. Use `user_identity_id` instead. IDs of the [user identities](/capability-guides/mobile-access/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity) that you want to associate with the client session.

## Response `200`

OK

- object
  - `client_session` ClientSession, required — Represents a [client session](/core-concepts/authentication/client-session-tokens). If you want to restrict your users' access to their own devices, use client sessions. See the [client_session object](/api/client_sessions/object).
    - `client_session_id` string, uuid, required — ID of the client session.
    - `connect_webview_ids` string[], required — IDs of the [Connect Webviews](/core-concepts/connect-webviews) associated with the [client session](/core-concepts/authentication/client-session-tokens).
    - `connected_account_ids` string[], required — IDs of the [connected accounts](/core-concepts/connected-accounts) associated with the [client session](/core-concepts/authentication/client-session-tokens).
    - `created_at` string, date-time, required — Date and time at which the [client session](/core-concepts/authentication/client-session-tokens) was created.
    - `customer_key` string — Customer key associated with the [client session](/core-concepts/authentication/client-session-tokens).
    - `device_count` number, float, required — Number of devices associated with the [client session](/core-concepts/authentication/client-session-tokens).
    - `expires_at` string, date-time, required — Date and time at which the [client session](/core-concepts/authentication/client-session-tokens) expires.
    - `token` string, required — Client session token associated with the [client session](/core-concepts/authentication/client-session-tokens).
    - `user_identifier_key` string, nullable, required — Your user ID for the user associated with the [client session](/core-concepts/authentication/client-session-tokens).
    - `user_identity_id` string, uuid — ID of the [user identity](/capability-guides/mobile-access/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity) associated with the client session.
    - `user_identity_ids` string[], required — Deprecated. Use `user_identity_id` instead. IDs of the [user identities](/capability-guides/mobile-access/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity) associated with the client session.
    - `workspace_id` string, uuid, required — ID of the workspace associated with the client session.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

[API](https://skmtc.net/seam/apis/seam-connect.md) · [All operations](https://skmtc.net/seam/apis/seam-connect/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/seam/seam-connect/versions/00c35395ce12/schema)