---
title: "POST /v1/session"
method: POST
path: "/v1/session"
tags: ["Sessions"]
---

# POST /v1/session

`POST /v1/session`

Creates a session that returns a client_secret which is required as a parameter when initializing the Fuse SDK.

## Headers

- `Fuse-Client-Id` string, required
- `Fuse-Api-Key` string, required
- `Plaid-Client-Id` string
- `Plaid-Secret` string
- `Teller-Application-Id` string
- `Teller-Certificate` string
- `Teller-Private-Key` string
- `Teller-Token-Signing-Key` string
- `Teller-Signing-Secret` string
- `Mx-Client-Id` string
- `Mx-Api-Key` string
- `Snaptrade-Client-Id` string
- `Snaptrade-Consumer-Key` string
- `Flinks-Ca-Customer-Id` string
- `Flinks-Us-Customer-Id` string
- `Flinks-Us-Instance-Id` string
- `Flinks-Ca-Instance-Id` string
- `Mono-Public-Key` string
- `Mono-Secret-Key` string
- `Mono-Webhook-Secret` string
- `TrueLayer-Client-Id` string
- `TrueLayer-Client-Secret` string
- `Finverse-Client-Id` string
- `Finverse-Client-Secret` string
- `Belvo-Secret-Id` string
- `Belvo-Secret-Password` string
- `Finicity-Partner-Secret` string
- `Finicity-Partner-Id` string
- `Finicity-App-Key` string
- `Basiq-Api-Key` string
- `Akoya-Client-Id` string
- `Akoya-Client-Secret` string
- `SaltEdge-App-Id` string
- `SaltEdge-App-Secret` string

## Request body

- CreateSessionRequest
  - `supported_financial_institution_aggregators` string[], required
  - `products` string[], required — List of products that you would like the institutions to support
  - `country_codes` string[] — List of country codes that you would like the institutions to support
  - `entity` object, required
    - `id` string, required — Unique identifier for the user or business account that is connecting to an institution. Use this id when calling the GET /entities/${entity_id} endpoint.
    - `name` string — Name for the user or business account. Required for EU connections.
    - `email` string — Email address associated with the user or business account. One of email/phone is required for EU connections.
    - `phone` string — Phone number associated with the user or business account. One of email/phone is required for EU connections.
  - `access_token` string — The fuse access token for an existing financial connection. This will perform the process to reconnect an existing disconnected account.
  - `is_web_view` boolean — Set to false for web SDKs (e.g., React), and true for mobile SDKs (e.g., React Native, Flutter, iOS, Android).

## Response `200`

Response

- CreateSessionResponse
  - `expiration` string, required — 4 hours from the point of creation
  - `client_secret` string, required — Token needed by the frontend sdk to start the process
  - `request_id` string, required — An identifier that is exclusive to the request and can serve as a means for investigating and resolving issues.

---

[API](https://skmtc.net/letsfuse/apis/sessions.md) · [All operations](https://skmtc.net/letsfuse/apis/sessions/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/letsfuse/sessions/revisions/816323e226dc/schema)