---
title: "Create a deposit switch"
method: POST
path: "/deposit_switch/create"
tags: ["plaid"]
---

# Create a deposit switch

`POST /deposit_switch/create`

This endpoint creates a deposit switch entity that will be persisted throughout the lifecycle of the switch.

## Request body

- DepositSwitchCreateRequest — DepositSwitchCreateRequest defines the request schema for `/deposit_switch/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.
  - `target_access_token` string, required — Access token for the target Item, typically provided in the Import Item response.
  - `target_account_id` string, required — Plaid Account ID that specifies the target bank account. This account will become the recipient for a user's direct deposit.
  - `country_code` 'US' | 'CA', nullable — ISO-3166-1 alpha-2 country code standard.
  - `options` DepositSwitchCreateRequestOptions — Options to configure the `/deposit_switch/create` request. If provided, cannot be `null`.
    - `webhook` string, nullable — The URL registered to receive webhooks when the status of a deposit switch request has changed.
    - `transaction_item_access_tokens` AccessToken[] — An array of access tokens corresponding to transaction items to use when attempting to match the user to their Payroll Provider. These tokens must be created by the same client id as the one creating the switch, and have access to the transactions product.

## Response `200`

OK

- DepositSwitchCreateResponse — DepositSwitchCreateResponse defines the response schema for `/deposit_switch/create`
  - `deposit_switch_id` string, required — ID of the deposit switch. This ID is persisted throughout the lifetime of the deposit switch.
  - `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

- **2024-02-21** `5de70cc1e6ca` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/plaid/apis/the-plaid-api/changes/deposit_switch/create/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/a5b45bccb4e8/schema)