---
title: "Create a session"
method: POST
path: "/link/v1/session"
tags: ["General.Tink Link.Session"]
---

# Create a session

`POST /link/v1/session`

You can optionally use a session to configure certain aspects of the Tink Link flow for a specific user (such as securely pre-filling information or configuring specific behaviors). A session is one-time use only and has a lifetime of 10 minutes.

## Request body

- V1SessionBody — The object contains the configuration for the Tink Link session.
  - `externalReference` string — The external reference identifier to be included in the report when using report based products. Maximum length of 50 characters.
  - `merchantId` string — Used when fetching themes/configuration for given merchant.
  - `personalIdentifier` string — The personal identifier to be pre-filled in username or social security number forms.
  - `sourceAccountNumber` string — The source account to be used in the payment flow (applicable for specific PSD2 providers).
  - `user` V1User
    - `firstName` string — The first name of the user to be used for User Match functionality
    - `lastName` string — The last name of the user to be used for User Match functionality

## Response `200`

A successful response.

- V1CreateSessionResponse
  - `sessionId` string

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/tink/apis/tink-api.md) · [All operations](https://skmtc.net/tink/apis/tink-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tink/tink-api/revisions/23d8982b533d/schema)