v3

latestOpenAPI 3.0.32026-07-31489099.0 KB
Financial Institutions

Register financial institution account

Registers a financial institution account using Plaid public token

post/accounts/{account_id}/financial-institutions/register-account

Path parameters

account_idstring required

ID of the resource

Example:2VZvtmVc2j3gQ80CTlcuQXbGrwC

Account ID

Request body

customer_webhook_urlstring uri required

URL where customer will receive webhook notifications when Plaid items need updates (required for account registration)

public_tokenstring required

The public token returned from Plaid Link

Example request

{
  "customer_webhook_url": "https://customer.com/webhooks/plaid-updates",
  "public_token": "public-sandbox-123456789"
}

Response

OK

financial_institution_idstring required

The ID of the created financial institution

Example response

{
  "financial_institution_id": "fi_123456789"
}