hubspot-webhooks-events

# HubSpot Webhooks & Events ## Overview Set up HubSpot webhook subscriptions for CRM events (contact/company/deal creation, updates, deletions) with v3 signature verification and idempotent event handling. ## Prerequisites - HubSpot public app (webhooks require a public app, not a private app) - Client secret from your app settings (for signature verification) - HTTPS endpoint accessible from the internet - Optional: Redis or database for idempotency ## Instructions ### Step 1: Understand HubSpot Webhook Events HubSpot sends webhook events as batches of CRM change notifications: ```json [ { "eventId": 100, "subscriptionId": 1234, "portalId": 12345678, "appId": 98765, "occurredAt": 1711234567890, "subscriptionType": "contact.propertyChange", "attemptNumber": 0, "objectId": 123, "propertyName": "lifecyclestage", "propertyValue": "marketingqualifiedlead", "changeSource": "CRM", "sourceId": "userId:12345" } ] ``` **Available subscription types:** - `contact.creation`, `contact.deletion`, `contact.propertyChange`, `contact.privacyDeletion` - `company.creation`, `company.deletion`, `company.propertyChange` - `deal.creation`, `deal.deletion`, `deal.propertyChange` - `ticket.creation`, `ticket.deletion`, `ticket.propertyChange` - `contact.merge`, `company.merge`, `deal.merge` - `contact.associationChange`, `company.associationChange`, `deal.associationChange` ### Step 2: Set Up Webhook Endpoint with Signature Verification ...