// plaid integration

Plaid webhook for linked-account events on localhost

Plaid posts webhooks when linked accounts produce events — new transactions, item update, error states. Sandbox flow against your laptop needs a public URL; lrok handles it.

1 · Set up the lrok tunnel

  1. 1. Reserve

    $ lrok reserve plaid-dev
  2. 2. Run handler

    $ npm run dev
  3. 3. Tunnel

    $ lrok http 3000 --hint plaid-dev

2 · Configure Plaid

  1. 1. Plaid Dashboard → Team Settings → Webhooks

    Webhook URL: https://plaid-dev.lrok.io/webhook. Different webhook URL per environment is allowed.

// plaid-specific gotcha

Plaid signs webhooks via JWT in the Plaid-Verification header. Verify with Plaid's webhookVerificationKey/get endpoint — the signing key rotates, so cache for ~24h. The body is the raw JSON Plaid sent.

More integrations