---
title: "POST /v1/link/token"
method: POST
path: "/v1/link/token"
tags: ["Link Tokens"]
---

# POST /v1/link/token

`POST /v1/link/token`

Create a link token to start the process of a user connecting to a specific financial institution.

## 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

- CreateLinkTokenRequest
  - `institution_id` string, required — An id that is unique for an institution.
  - `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.
  - `client_name` string, required — The name of your application. This is what will be displayed to users.
  - `session_client_secret` string, required — The session client secret created from the 'Create session client secret' endpoint
  - `webhook_url` string — This field allows you to set a unique webhook URL for each individual entity. By specifying an entity-specific webhook URL, you can receive and process data events for each entity separately. If this field is left empty, the organization-wide webhook URL set in the sandbox/production environment will be used as the default for all entities.
  - `mx` object — An object specifying information about the MX configuration to use for deciding which MX supported financial institutions to display.
    - `config` object — Follows the same schema as MX's request a connect url(https://docs.mx.com/api#connect_request_a_url) schema.
  - `plaid` object — An object specifying information about the Plaid configuration to use when creating a link token.
    - `config` object — Follows the same schema as Plaid's Link Token Create Schema(https://plaid.com/docs/api/tokens/#linktokencreate). 'products', 'client_id', 'secret', 'client_user_id', 'client_name', 'webhook', 'institution_data' and 'country_codes' (only US and Canada is supported right now) will be set by Fuse and override any values you set.
  - `teller` object — An object specifying information about the Teller configuration to use when creating a link token.
    - `config` object
      - `selectAccount` 'disabled' | 'single' | 'multiple' — The mode of account selection: - 'disabled': automatically connect all the supported financial accounts associated with this user's account at the institution (default). - 'single': the user will see a list of supported financial accounts and will need to select one to connect - 'multiple': the user will see a list of supported financial accounts and will need to select one or more to connect
      - `accountFilter` object — Filter the types of account returned by Teller when enrolling a customer
        - `depository` union
          - 'all'
          - object
            - `subtypes` string[]
        - `credit` union
          - 'all'
          - object
            - `subtypes` string[]
  - `snaptrade` object — An object specifying information about the SnapTrade configuration to use when creating a link token.
    - `config` object
      - `connectionType` 'read' | 'trade' — SnapTrade connection type. Defaults to 'read'

## Response `200`

Response

- CreateLinkTokenResponse
  - `link_token` string, required — Token needed by the frontend sdk to initiate the connection
  - `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)