Funding Source Webhooks

Event Types

Event Name	Description
`funding-source.added`	A new bank account has been successfully added to a customer.
`funding-source.updated`	The bank account information has been successfully updated.
`funding-source.verified`	The bank account has been successfully verified.
`funding-source.deleted`	The bank account has been successfully removed.
`funding-source.made-primary`	The bank account is designated as the primary account for payments.
`funding-source.made-billing`	The bank account is set up for fee deductions.
`funding-source.initiated-micro-deposits`	Deprecated as of June 8, 2026. Replaced by `funding-source.pending-verification`, which covers all Plaid waterfall verification paths..
`funding-source.pending-verification`	Fired when a bank account is connected but verification is still in progress (automated micro-deposits, same-day micro-deposits, etc.). Includes Plaid verification status and channel.
`funding-source.verification-failed`	Fired when Plaid marks the verification as failed — e.g. wrong micro-deposit code entered 3 times, or Database Match failed.
`funding-source.verification-expired`	Fired when automated micro-deposit verification was not completed within the allowed window. The funding source is deleted and the customer must re-add the bank account.

Example Payload

{
  "event": "funding-source.pending-verification",
  "event_id": "evt_1770998350_0092ac965b63_12",
  "webhook_version": "2025-08-21",
  "customer_id": "e324d290-08f4-11f1-85d8-11a7e03ece9a",
  "source_id": null,
  "institution": {
    "id": "ins_109512",
    "name": "Houndstooth Bank"
  },
  "plaid": {
    "item_id": "L7rQd3QqnPubokqR7gJxiv5PvRxDJ8tkoyy6Q",
    "account_id": "p8ylr7lWEASEaKd95J7oS7Wm7BnQkZfpkNNlg",
    "verification_status": "pending_automatic_verification",
    "verification_channel": "automated_md"
  },
  "status": "pending_verification",
  "timestamp": "2026-02-19 15:59:10"
}

`verification_channel` values table

Value	Description
`instant_auth`	Instant Auth via bank credentials
`instant_match`	Instant Match
`instant_md`	Instant Micro-deposits
`same_day_md`	Same-Day Micro-deposits (manual code entry)
`automated_md`	Automated Micro-deposits (auto-verified by Plaid)
`database_insights`	Database Match

`verification_status` values table

Value	Description
`pending_manual_verification`	Waiting for customer to enter micro-deposit code
`pending_automatic_verification`	Plaid will verify automatically
`automatically_verified`	Verified automatically by Plaid
`manually_verified`	Verified by customer entering the code
`verification_failed`	Verification failed
`verification_expired`	Verification window expired

Event Types

Example Payload

verification_channel values table

verification_status values table

`verification_channel` values table

`verification_status` values table