Webhooks Event Catalog

Event Types

Data Entity Events

Data entity events follow EntityName.operation and generally use thin payloads.

Example payload:

{
  "id": "Customer_created_7bcef4fd-9458-49d0-a7e7-589f5e6f2683_03f6c94f-574d-42ca-a6cd-fecf2a2aeccb",
  "type": "Customer.created",
  "business_id": "8e7a359e-7af5-4f6e-b786-6ddfd1807c32",
  "business_external_id": "biz_101",
  "data": {
    "entity_id": "7bcef4fd-9458-49d0-a7e7-589f5e6f2683",
    "entity_external_id": "cust_2001"
  }
}

Entity	Events
BankTransaction	BankTransaction.created, BankTransaction.updated, BankTransaction.archived
Bill	Bill.created, Bill.updated, Bill.archived
BillPayment	BillPayment.created, BillPayment.updated, BillPayment.archived
Business	Business.created, Business.updated, Business.archived
BusinessTask	BusinessTask.created, BusinessTask.updated, BusinessTask.archived
Customer	Customer.created, Customer.updated, Customer.archived
CustomerCredit	CustomerCredit.created, CustomerCredit.updated, CustomerCredit.archived
CustomerPayout	CustomerPayout.created, CustomerPayout.updated, CustomerPayout.archived
CustomerRefund	CustomerRefund.created, CustomerRefund.updated, CustomerRefund.archived
GeneralLedgerAccount	GeneralLedgerAccount.created, GeneralLedgerAccount.updated, GeneralLedgerAccount.archived
Invoice	Invoice.created, Invoice.updated, Invoice.archived
InvoicePayment	InvoicePayment.created, InvoicePayment.updated, InvoicePayment.archived
InvoiceWriteOff	InvoiceWriteOff.created, InvoiceWriteOff.updated, InvoiceWriteOff.archived
TaxProfile	TaxProfile.created, TaxProfile.updated, TaxProfile.archived
TimeEntry	TimeEntry.created, TimeEntry.updated, TimeEntry.archived
Trip	Trip.created, Trip.updated, Trip.archived
Vehicle	Vehicle.created, Vehicle.updated, Vehicle.archived
Vendor	Vendor.created, Vendor.updated, Vendor.archived
VendorCredit	VendorCredit.created, VendorCredit.updated, VendorCredit.archived
VendorPayout	VendorPayout.created, VendorPayout.updated, VendorPayout.archived
VendorRefund	VendorRefund.created, VendorRefund.updated, VendorRefund.archived

Events with additional metadata

BusinessTask lifecycle webhooks include the current active task count for the business in addition to the standard lifecycle entity fields.

Show BusinessTask example payload

{
  "id": "BusinessTask_created_7bcef4fd-9458-49d0-a7e7-589f5e6f2683_03f6c94f-574d-42ca-a6cd-fecf2a2aeccb",
  "type": "BusinessTask.created",
  "business_id": "8e7a359e-7af5-4f6e-b786-6ddfd1807c32",
  "business_external_id": "biz_101",
  "data": {
    "entity_id": "7bcef4fd-9458-49d0-a7e7-589f5e6f2683",
    "entity_external_id": null,
    "open_task_count": 3
  }
}

User Activity Events

User activity events use the activity.* namespace.

Example payload:

{
  "id": "activity_categorize_bank_transaction_44bb48bd-4af1-4e6f-a38a-fb24e5575dc7",
  "type": "activity.categorize_bank_transaction",
  "business_id": "8e7a359e-7af5-4f6e-b786-6ddfd1807c32",
  "business_external_id": "biz_101",
  "data": {
    "transaction_id": "34db2910-5919-4985-8e7f-56dd83e76ed5",
    "categorization_method": "API",
    "categorization": null,
    "matchType": "INVOICE_PAYMENT",
    "created_at": "2026-03-31T16:42:11Z"
  }
}

• activity.categorize_bank_transaction
• activity.load_pnl
• activity.load_balance_sheet
• activity.load_cashflow_statement
• activity.create_custom_account
• activity.archive_custom_account
• activity.reactivate_custom_account
• activity.upload_custom_account_csv
• activity.export_pnl_csv
• activity.export_pnl_excel
• activity.export_pnl_comparison_csv
• activity.export_pnl_month_over_month
• activity.export_pnl_line_item_excel
• activity.export_balance_sheet_csv
• activity.export_balance_sheet_excel
• activity.export_cashflow_csv
• activity.export_transactions_csv
• activity.export_transactions_excel
• activity.export_pnl_pdf
• activity.generate_tax_packet

SMS Events

SMS events use the sms.* namespace.

Example payload:

{
  "id": "sms_message_received_SM1234567890",
  "type": "sms.message_received",
  "business_id": "8e7a359e-7af5-4f6e-b786-6ddfd1807c32",
  "business_external_id": "biz_101",
  "data": {
    "message_id": "SM1234567890",
    "direction": "RECEIVED",
    "body": "Classify this as utilities",
    "phone_number": "[phone]",
    "delivery_status": null,
    "at": "2026-03-31T16:48:55Z"
  }
}

• sms.message_received
• sms.message_delivered
• sms.message_delivery_failed

External Account Events

External account events use the external_accounts.* namespace. These events include the current count of external accounts that need repair for the business.

Example payload:

{
  "id": "external_accounts_link_connected_03f6c94f-574d-42ca-a6cd-fecf2a2aeccb",
  "type": "external_accounts.link.connected",
  "business_id": "8e7a359e-7af5-4f6e-b786-6ddfd1807c32",
  "business_external_id": "biz_101",
  "data": {
    "provider": "plaid",
    "at": "2026-03-31T16:50:29Z",
    "link_id": "719b0d31-ba7b-4f1b-982a-c6334b0a544b",
    "external_link_id": "plaid_item_123",
    "account_ids": [
      "92762148-f10b-42a5-b37f-b1e23fa3faca"
    ],
    "external_account_ids": [
      "plaid_account_456"
    ],
    "accounts_needing_repair_count": 1
  }
}

• external_accounts.link.connected
• external_accounts.link.disconnected
• external_accounts.link.archived
• external_accounts.link.reactivated
• external_accounts.link.needs_repair
• external_accounts.link.repaired
• external_accounts.account.connected
• external_accounts.account.archived
• external_accounts.account.reactivated
• external_accounts.account.needs_repair
• external_accounts.account.repaired

Bookkeeping Onboarding Events

Bookkeeping onboarding events notify your application at the end of a business’s Layer bookkeeping onboarding call, when their bookkeeping configuration’s onboarding_date is set for the first time.

Example payload:

{
  "id": "bookkeeping_onboarding_completed_00000000-0000-0000-0000-000000000002_03f6c94f-574d-42ca-a6cd-fecf2a2aeccb",
  "type": "bookkeeping_onboarding.completed",
  "business_id": "8e7a359e-7af5-4f6e-b786-6ddfd1807c32",
  "business_external_id": "biz_101",
  "data": {
    "bookkeeping_configuration_id": "00000000-0000-0000-0000-000000000002",
    "onboarding_date": "2024-01-15"
  }
}

• bookkeeping_onboarding.completed

Payload Fields

Field	Type	Description
id	string	Unique identifier for this webhook event
type	string	Always bookkeeping_onboarding.completed
business_id	string (UUID)	The Layer business ID
business_external_id	string or null	Your external identifier for the business, if set
data.bookkeeping_configuration_id	string (UUID)	The ID of the bookkeeping configuration that completed onboarding
data.onboarding_date	string (date)	The date when bookkeeping onboarding was completed, in YYYY-MM-DD format

When This Webhook Fires

The bookkeeping_onboarding.completed webhook fires when Layer updates the business’s bookkeeping configuration at the end of their onboarding call.

This webhook only fires when the onboarding_date transitions from unset (null) to a value. Subsequent updates to onboarding_date do not trigger additional webhooks.