---
title: "Create Session Creation Token"
slug: "create-session-creation-token"
updated: 2026-11-11T18:20:49Z
published: 2026-11-11T18:20:49Z
canonical: "docs.onespan.com/create-session-creation-token"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.onespan.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Session Creation Token

The Create Session Creation Token API generates a new session creation token for existing transactions. A new session creation token is required when the old token has expired and the transaction is still valid.

## Syntax

POST /api/transaction/transaction_id/token

## Examples

### Example request

POST /api/transaction/00000000-0000-0000-0000-000000000000/token HTTP/1.1

Host: onespan.com

Accept: application/json, text/javascript

Sample payload:

{

"role": "unknown"

}

### Example response

HTTP/1.1 200 OK

Vary: Accept

Content-Type: application/json

{

"token": "<token key>",

"role": "unknown"

}

### Headers

The following headers are included in the request and the response:

#### Request headers

- [Accept](https://tools.ietf.org/html/rfc7231#section-5.3.2): The response content type depends on the Accept header.
- [Authorization](https://tools.ietf.org/html/rfc7235#section-4.2): The OAuth/JWT token to authenticate.

#### Response headers

- [Content-Type](https://tools.ietf.org/html/rfc7231#section-3.1.1.5): application/json

### Status codes

| **Status codes** |
| --- |
| Status code | Name | Description |
| 200 | OK | No error. |
| 400 | Bad Request | The transaction data is invalid. |
| 401 | Unauthorized | Invalid token. |
| 403 | Forbidden | The token does not grant transaction creation rights. |
| 500 | Internal Server Error | Server or application error. |