---
title: "(Deprecated) Create an income verification instance"
method: POST
path: "/income/verification/create"
tags: ["plaid"]
deprecated: true
---

# (Deprecated) Create an income verification instance

`POST /income/verification/create`

> **Deprecated.**

`/income/verification/create` begins the income verification process by returning an `income_verification_id`. You can then provide the `income_verification_id` to `/link/token/create` under the `income_verification` parameter in order to create a Link instance that will prompt the user to go through the income verification flow. Plaid will fire an `INCOME` webhook once the user completes the Payroll Income flow, or when the uploaded documents in the Document Income flow have finished processing.

## Request body

- IncomeVerificationCreateRequest — IncomeVerificationCreateRequest defines the request schema for `/income/verification/create`
  - `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.
  - `webhook` string, required — The URL endpoint to which Plaid should send webhooks related to the progress of the income verification process.
  - `precheck_id` string — The ID of a precheck created with `/income/verification/precheck`. Will be used to improve conversion of the income verification flow.
  - `options` IncomeVerificationCreateRequestOptions — Optional arguments for `/income/verification/create`
    - `access_tokens` AccessToken[] — An array of access tokens corresponding to the Items that will be cross-referenced with the product data. Plaid will attempt to correlate transaction history from these Items with data from the user's paystub, such as date and amount. If the `transactions` product was not initialized for the Items during Link, it will be initialized after this Link session.

## Response `200`

OK

- IncomeVerificationCreateResponse — IncomeVerificationCreateResponse defines the response schema for `/income/verification/create`.
  - `income_verification_id` string, required — ID of the verification. This ID is persisted throughout the lifetime of the verification.
  - `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.

## Other responses

- `default` — Error response

---

[API](https://skmtc.net/plaid/apis/the-plaid-api.md) · [All operations](https://skmtc.net/plaid/apis/the-plaid-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/plaid/the-plaid-api/versions/64c4514ea59b/schema)