Record an agent external account ACH validation
Records that the platform validated the account’s routing and account numbers through Plaid Auth and matched an owner reported by Plaid Identity to the customer’s verified name or business legal name. Grid counts it as an ACH account validation for that account; ACH_PULL deposits require one. Refused with 400 if ownerNameMatched is false or the account is not a USD account of the agent’s customer. This endpoint uses platform credentials, not agent credentials.
Authorizations
API token authentication using format <api token id>:<api client secret>
Path Parameters
System-generated unique agent identifier
System-generated unique external account identifier
Body
Plaid account and owner validation performed by the platform.
Method used to validate the account's routing and account numbers.
PLAID_AUTH "PLAID_AUTH"
Must be true: the platform matched an account owner reported by Plaid Identity to the customer's verified name or business legal name. Grid refuses the request when it is false.
true
When the platform validated the account and matched its owner.
"2026-10-09T17:55:00Z"
Name of the bank reported by Plaid.
255"Chase"
Response
The recorded ACH account validation
An ACH account validation accepted for pulls from this external account.
The customer's external account that was validated.
"ExternalAccount:019542f5-b3e7-1d02-0000-000000000003"
Method used to validate the account's routing and account numbers.
PLAID_AUTH "PLAID_AUTH"
When the platform validated the account and matched its owner.
"2026-10-09T17:55:00Z"
Name of the bank reported by Plaid, when provided.
255"Chase"