---
title: "Import Item"
method: POST
path: "/item/import"
tags: ["plaid"]
---

# Import Item

`POST /item/import`

`/item/import` creates an Item via your Plaid Exchange Integration and returns an `access_token`. As part of an `/item/import` request, you will include a User ID (`user_auth.user_id`) and Authentication Token (`user_auth.auth_token`) that enable data aggregation through your Plaid Exchange API endpoints. These authentication principals are to be chosen by you.

Upon creating an Item via `/item/import`, Plaid will automatically begin an extraction of that Item through the Plaid Exchange infrastructure you have already integrated.

## Request body

- ItemImportRequest — ItemImportRequest defines the request schema for `/item/import`
  - `client_id` string — Your Plaid API `client_id`. The `client_id` is required and may be provided either in the `PLAID-CLIENT-ID` header or as part of a request body.
  - `secret` string — Your Plaid API `secret`. The `secret` is required and may be provided either in the `PLAID-SECRET` header or as part of a request body.
  - `institution_id` string — The Plaid Institution ID associated with the Item.
  - `products` Products[], required — Array of product strings
  - `user_auth` ItemImportRequestUserAuth, required — Object of user ID and auth token pair, permitting Plaid to aggregate a user’s accounts
    - `user_id` string, required — Opaque user identifier
    - `auth_token` string, required — Authorization token Plaid will use to aggregate this user’s accounts
  - `options` ItemImportRequestOptions — An optional object to configure `/item/import` request.
    - `webhook` string — Specifies a webhook URL to associate with an Item. Plaid fires a webhook if credentials fail.

## Response `200`

OK

- ItemImportResponse — ItemImportResponse defines the response schema for `/item/import`
  - `access_token` string, required — The access token associated with the Item data is being requested for.
  - `request_id` string, required — A unique identifier for the request, which can be used for troubleshooting. This identifier, like all Plaid identifiers, is case sensitive.

## Changes

- **2025-05-21** `5eae3158bbfc` — 1 info
  - added the new `protect_linked_bank` enum value to the request property `products/items/`
- **2025-05-19** `02e6d58e95e9` — 1 info
  - added the new optional request property `institution_id`
- **2025-01-15** `5dbeedb71831` — 1 info
  - added the new `transactions_refresh` enum value to the request property `products/items/`
- **2024-11-14** `b0263533029b` — 1 info
  - added the new `cra_network_insights` enum value to the request property `products/items/`
- **2024-10-09** `36052f62cce1` — 1 breaking, 1 info
  - removed the enum value `deposit_switch` of the request property `products/items/`
  - added the new `pay_by_bank` enum value to the request property `products/items/`

[Full history](https://skmtc.dev/plaid/apis/the-plaid-api/changes/item/import/post.md)

---

[API](https://skmtc.dev/plaid/apis/the-plaid-api.md) · [All operations](https://skmtc.dev/plaid/apis/the-plaid-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/plaid/the-plaid-api/revisions/5eae3158bbfc/schema)