---
title: "Create Plaid Link Token"
method: POST
path: "/ach/plaid/link_token/create"
tags: ["ACH"]
---

# Create Plaid Link Token

`POST /ach/plaid/link_token/create`

Used to create a Plaid Link token to use with the Plaid Link UI.

**Integration Methods:**
- Host Direct

See the [Integration Methods](/guides/quickstart#integration-methods) and [URLs Section](/guides/quickstart#urls) sections of the Development Quick Start guide for details regarding each processing option.

## Headers

- `InterfaceVersion` string, required
- `InterfaceName` string, required
- `CompanyName` string, required
- `AccessToken` string, uuid, required

## Request body

- object
  - `dateTime` string, ISO 8601, required — The date and time in ISO 8601 format including the timezone offset (yyyy-mm-ddThh:mm:ss.nnn+hh:mm). Must be sent as the local date/time of the merchant. For example, a request processed at a merchant in the Pacific time zone at 9:18am on April 15th 2021 would be sent as 2021-04-15T09:18:23.283-07:00
  - `plaid` object, required
    - `client_user_id` string, required — A unique ID representing the end user. Typically this will be a user ID number from your application. Personally identifiable information, such as an email address or phone number, should not be used in the client_user_id.
    - `language` 'da' | 'nl' | 'en' | 'et' | 'fr' | 'de' | 'it' | 'lv' | 'lt' | 'no' | 'po' | 'ro' | 'es' | 'se' — The language that Link should be displayed in. If no language is sent it will default to English. Value | Description ------|------------- da | Danish nl | Dutch en | English et | Estonian fr | French de | German it | Italian lv | Latvian lt | Lithuanian no | Norwegian po | Polish ro | Romanian es | Spanish se | Swedish
    - `redirectUrl` string — Contains the URL to which the browser should be redirected. **Conditional: must be sent if the customer is using a 'mobile device' or 'website with redirection'. Also the same url needs to be provided during onboarding or later via LBM.**

## Response `200`

Request was processed

- object
  - `result` object[]
    - `dateTime` string, ISO 8601 — The date and time in ISO 8601 format including the timezone offset (yyyy-mm-ddThh:mm:ss.nnn+hh:mm). Must be sent as the local date/time of the merchant. For example, a request processed at a merchant in the Pacific time zone at 9:18am on April 15th 2021 would be sent as 2021-04-15T09:18:23.283-07:00
    - `merchant` MerchantResponse
      - `mid` number — The merchant ID associated with the merchant account.
      - `name` string — The merchant’s business name as configured with Shift4.
    - `transaction` object
      - `authSource` 'A' — In a response, a code returned by the processor to indicate which host issued the response. Value | Description -------|---------------------------- A | APM (Online)
      - `responseCode` 'S' | 'F' — Code indicating the Shift4 host response. Value | Description | Details -------|-------------|-------- S | Success | The Plaid link token request was successful. F | Fail | The Plaid link token request was unsuccessful.
    - `plaid` object
      - `link_token` string — Plaid Link Token
      - `expiration` string — Plaid Link Token Expiration
      - `client_user_id` string — A unique ID representing the end user. Typically this will be a user ID number from your application. Personally identifiable information, such as an email address or phone number, should not be used in the client_user_id.
    - `server` Server
      - `name` string — The name of the server that processed the request.

## Other responses

- `400` — Error
- `504` — Timeout

---

[API](https://skmtc.dev/shift4/apis/shift4-payment-api.md) · [All operations](https://skmtc.dev/shift4/apis/shift4-payment-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/shift4/shift4-payment-api/revisions/2f85c87cc9e5/schema)