Create a Client Session

Create a new client session

Creates a new client session.

/client_sessions/create

POSThttps://connect.getseam.com/client_sessions/create
Body
user_identifier_keystring
connect_webview_idsarray of string
connected_account_idsarray of string
user_identity_idsarray of string
expires_atstring (date-time)
Response

OK

Body
client_session*client_session (object)
ok*boolean
Request
const response = await fetch('https://connect.getseam.com/client_sessions/create', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();
Response
{
  "client_session": {
    "client_session_id": "123e4567-e89b-12d3-a456-426614174000",
    "workspace_id": "123e4567-e89b-12d3-a456-426614174000",
    "created_at": "2024-07-14T16:03:35.603Z",
    "token": "text",
    "user_identifier_key": "text",
    "device_count": 0,
    "connected_account_ids": [
      "123e4567-e89b-12d3-a456-426614174000"
    ],
    "connect_webview_ids": [
      "123e4567-e89b-12d3-a456-426614174000"
    ],
    "user_identity_ids": [
      "123e4567-e89b-12d3-a456-426614174000"
    ]
  },
  "ok": false
}

Request

Specify the user ID and, optionally, connected accounts associated with the user by including the corresponding parameters in the request body.

Request Body Parameters

ParameterTypeDescription

user_identifier_key

String Required

Your own internal user ID for the user

connected_account_ids

Array of strings Optional

Array of IDs of the connected accounts associated with this user

Sample Request

await seam.clientSessions.create({
  user_identifier_key: "internal-user-id-1",
  connected_account_ids: [
    "3ea0b67f-649f-4131-bfe3-f2035e77a3f9",
    "6e1cad57-b244-40ca-b4f3-30a46c8000d4",
  ]
})

Response

Returns a client_session containing the following properties:

PropertyDescription

token

Client session token associated with the client session

workspace_id

ID of the workspace that contains the client session

user_identifier_key

Your own internal user ID for the user

client_session_id

ID of the client session

created_at

Date and time at which the client session was created

This response also includes a Boolean ok status indicator.

Sample Response

{
  token: 'seam_cst12GGG4LUp_AoHvcSx39aY4AoHQ7GdMDRTH',
  workspace_id: '398d80b7-3f96-47c2-b85a-6f8ba21d07be',
  user_identifier_key: 'internal user ID 1',
  client_session_id: '911b4a3f-e566-44a9-a8ac-267d9e586754',
  created_at: '2023-12-26T05:11:55.048Z'
}

Last updated

Logo

Š Seam Labs, Inc. All rights reserved.