Skip to main content
Webhooks let your platform receive HTTP callbacks when events occur in Lemma. Instead of polling our API, you register a URL and we send a POST request to it whenever a relevant event fires. To configure a webhook endpoint, contact the Lemma team with the URL you’d like to receive events at. We’re building a self-serve UI to manage endpoint URLs directly from the dashboard.

Events

entity.connected

Fired when an entity connects their Lemma account to your platform. This is the primary event for onboarding — use it to know when a new entity has authorized your API key to access their data. The payload includes the entity ID and basic details so you can immediately start pulling their accounts, transactions, and lockbox mail.
{
  "event": "entity.connected",
  "entity": {
    "id": "entity_k7mXp2vR9nTfBw4s",
    "name": "Riverside Family Medicine",
    "structure": "professional_llc",
    "npi": "1234567890"
  },
  "occurred_at": "2026-03-15T14:30:00Z"
}
After receiving this event, you can call the Get entity, List bank accounts, and other entity-scoped endpoints using the entity.id from the payload.

transaction.created

Fired when a new transaction posts to any account accessible to your API key. This includes incoming deposits (ACH, wire, check), outbound transfers, and internal movements between Lemma accounts.
{
  "event": "transaction.created",
  "transaction": {
    "id": "transaction_Wp5mRx3nKv8bTh2d",
    "account_id": "account_Rv4nBt8xKw2pMh6s",
    "amount": 325000,
    "source": {
      "category": "check_deposit"
    },
    "counterparty": {
      "type": "external_account",
      "external_account": {
        "external_account_id": "external_account_Bx5nTm8hKw3pVd7c"
      }
    },
    "occurred_at": "2026-03-15T16:45:00Z"
  },
  "occurred_at": "2026-03-15T16:45:00Z"
}
Use this event to sync transactions in real time instead of polling the List transactions endpoint.