Deposit Switch

depositSwitchCreate

POST
/deposit_switch/create

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

Authorization

PLAID-CLIENT-ID PLAID-SECRET Plaid-Version
PLAID-CLIENT-ID<token>

In: header

PLAID-SECRET<token>

In: header

Plaid-Version<token>

In: header

Request Body

application/json

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

Access token for the target Item, typically provided in the Import Item response.

target_account_id*string

Plaid Account ID that specifies the target bank account. This account will become the recipient for a user's direct deposit.

country_code?CountryCode1

ISO-3166-1 alpha-2 country code standard.

Value in

  • "US"
  • "CA"
options?

Options to configure the /deposit_switch/create request. If provided, cannot be null.

Response Body

application/json

curl -X POST "https://example.com/deposit_switch/create" \  -H "Content-Type: application/json" \  -d '{    "target_access_token": "string",    "target_account_id": "string"  }'
{  "deposit_switch_id": "c7jMwPPManIwy9rwMewWP7lpb4pKRbtrbMomp",  "request_id": "lMjeOeu9X1VUh1F"}