{
  "generated_from": "hookdeck/webhook-registry",
  "registry_commit": "a24c8d9784c9e9fe937c63f76adbce108201378f",
  "registry_committed_at": "2026-11-19T08:56:09Z",
  "disclaimer": "Independent reference. Not affiliated with HubSpot.",
  "vendor": "hubspot",
  "name": "HubSpot",
  "official_docs": "https://developers.hubspot.com/docs/api-reference/legacy/webhooks/guide",
  "docs_checked": "2026-10-28",
  "url": "https://hookdeck.com/webhooks/hubspot",
  "pages": [
    {
      "tab": "overview",
      "label": "Overview",
      "url": "https://hookdeck.com/webhooks/hubspot"
    },
    {
      "tab": "events",
      "label": "Webhook events",
      "url": "https://hookdeck.com/webhooks/hubspot/events"
    },
    {
      "tab": "mcp-events",
      "label": "MCP events",
      "url": "https://hookdeck.com/webhooks/hubspot/mcp-events"
    },
    {
      "tab": "verify",
      "label": "Verify signatures",
      "url": "https://hookdeck.com/webhooks/hubspot/verify"
    },
    {
      "tab": "guide",
      "label": "Production guide",
      "url": "https://hookdeck.com/webhooks/hubspot/guide-duplicates-ordering-retries-timeouts"
    },
    {
      "tab": "skill",
      "label": "Agent skill",
      "url": "https://hookdeck.com/webhooks/hubspot/skill"
    }
  ],
  "summary": "HubSpot signs every webhook with X-HubSpot-Signature-v3 (HMAC-SHA256, base64). Deliveries also carry the legacy X-HubSpot-Signature, X-HubSpot-Signature-Version.",
  "facts": [
    {
      "key": "signature_header",
      "label": "Signature header",
      "value": "X-HubSpot-Signature-v3",
      "detail": "Format: <base64>",
      "source": {
        "kind": "vendor-docs",
        "label": "HubSpot docs",
        "href": "https://developers.hubspot.com/docs/apps/developer-platform/build-apps/authentication/request-validation"
      },
      "doc_discrepancy": null
    },
    {
      "key": "scheme",
      "label": "Scheme",
      "value": "HMAC-SHA256, base64",
      "detail": null,
      "source": {
        "kind": "vendor-docs",
        "label": "HubSpot docs",
        "href": "https://developers.hubspot.com/docs/apps/developer-platform/build-apps/authentication/request-validation"
      },
      "doc_discrepancy": null
    },
    {
      "key": "signed_material",
      "label": "Signed material",
      "value": "{method}{uri}{body}{timestamp}",
      "detail": "The HTTP method, the full URI HubSpot called with the listed percent-encoded characters decoded, the body as sent, then the X-HubSpot-Request-Timestamp header, with no separators.",
      "source": {
        "kind": "vendor-docs",
        "label": "HubSpot docs",
        "href": "https://developers.hubspot.com/docs/apps/developer-platform/build-apps/authentication/request-validation"
      },
      "doc_discrepancy": null
    },
    {
      "key": "identified_by",
      "label": "How events are identified",
      "value": "subscriptionType field in the body",
      "detail": null,
      "source": {
        "kind": "vendor-docs",
        "label": "HubSpot docs",
        "href": "https://developers.hubspot.com/docs/api-reference/latest/webhooks/guide"
      },
      "doc_discrepancy": null
    },
    {
      "key": "body_format",
      "label": "Body format",
      "value": "JSON",
      "detail": "Content type: application/json.",
      "source": {
        "kind": "vendor-docs",
        "label": "HubSpot docs",
        "href": "https://developers.hubspot.com/docs/api-reference/latest/webhooks/guide"
      },
      "doc_discrepancy": null
    },
    {
      "key": "timestamp",
      "label": "Send timestamp",
      "value": "X-HubSpot-Request-Timestamp",
      "detail": "Reject deliveries older than 5 minutes.",
      "source": {
        "kind": "vendor-docs",
        "label": "HubSpot docs",
        "href": "https://developers.hubspot.com/docs/apps/developer-platform/build-apps/authentication/request-validation"
      },
      "doc_discrepancy": null
    },
    {
      "key": "legacy_signature",
      "label": "Legacy signature",
      "value": "X-HubSpot-Signature, X-HubSpot-Signature-Version",
      "detail": "A plain SHA-256 hex digest, not an HMAC: secret + body for v1, secret + method + URI + body for v2, as named by X-HubSpot-Signature-Version.",
      "source": {
        "kind": "vendor-docs",
        "label": "HubSpot docs",
        "href": "https://developers.hubspot.com/docs/apps/developer-platform/build-apps/authentication/request-validation"
      },
      "doc_discrepancy": null
    },
    {
      "key": "other_headers",
      "label": "Other headers",
      "value": "x-hubspot-client-ip, x-hubspot-correlation-id, x-hubspot-request-timestamp, x-hubspot-requesting-chain-bin, x-hubspot-signature-version, x-hubspot-timeout-millis, x-trace",
      "detail": null,
      "source": {
        "kind": "registry",
        "label": "Registry record",
        "href": "https://hookdeck.com/webhooks/hubspot.json"
      },
      "doc_discrepancy": null
    },
    {
      "key": "agent_skill",
      "label": "Agent skill",
      "value": "npx skills add hookdeck/webhook-skills --skill hubspot-webhooks",
      "detail": null,
      "source": {
        "kind": "webhook-skills",
        "label": "Agent skill →",
        "href": "https://hookdeck.com/webhooks/hubspot/skill"
      },
      "doc_discrepancy": null
    }
  ],
  "not_yet_known": [],
  "enumeration": {
    "status": "partial",
    "source_url": "https://developers.hubspot.com/docs/api-reference/legacy/webhooks/guide",
    "checked": "2026-07-28"
  },
  "counts": {
    "events": 47,
    "with_payload": 4,
    "captured": 0,
    "with_description": 47,
    "resources": 8,
    "confidence": {
      "verified": 0,
      "documented": 47,
      "inferred": 0
    }
  },
  "mcp": {
    "native": "unknown",
    "checked": null,
    "via_hookdeck": "any HubSpot event"
  },
  "events": [
    {
      "name": "contact.creation",
      "resource": "contact",
      "description": "A new contact is created",
      "confidence": "documented",
      "schema_source": "from HubSpot docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/hubspot/events#contact.creation",
      "json": "https://hookdeck.com/webhooks/hubspot/events/contact-creation.json"
    },
    {
      "name": "contact.propertyChange",
      "resource": "contact",
      "description": "A subscribed property changes on a contact",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/hubspot/events#contact.propertyChange",
      "json": "https://hookdeck.com/webhooks/hubspot/events/contact-propertychange.json"
    },
    {
      "name": "contact.deletion",
      "resource": "contact",
      "description": "A contact is deleted",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/hubspot/events#contact.deletion",
      "json": "https://hookdeck.com/webhooks/hubspot/events/contact-deletion.json"
    },
    {
      "name": "company.creation",
      "resource": "company",
      "description": "A new company is created",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/hubspot/events#company.creation",
      "json": "https://hookdeck.com/webhooks/hubspot/events/company-creation.json"
    },
    {
      "name": "company.propertyChange",
      "resource": "company",
      "description": "A subscribed property changes on a company",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/hubspot/events#company.propertyChange",
      "json": "https://hookdeck.com/webhooks/hubspot/events/company-propertychange.json"
    },
    {
      "name": "deal.creation",
      "resource": "deal",
      "description": "A new deal is created",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/hubspot/events#deal.creation",
      "json": "https://hookdeck.com/webhooks/hubspot/events/deal-creation.json"
    },
    {
      "name": "deal.propertyChange",
      "resource": "deal",
      "description": "A subscribed property changes on a deal",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/hubspot/events#deal.propertyChange",
      "json": "https://hookdeck.com/webhooks/hubspot/events/deal-propertychange.json"
    },
    {
      "name": "ticket.creation",
      "resource": "ticket",
      "description": "A new ticket is created",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/hubspot/events#ticket.creation",
      "json": "https://hookdeck.com/webhooks/hubspot/events/ticket-creation.json"
    },
    {
      "name": "contact.merge",
      "resource": "contact",
      "description": "Two contacts are merged into one",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/hubspot/events#contact.merge",
      "json": "https://hookdeck.com/webhooks/hubspot/events/contact-merge.json"
    },
    {
      "name": "contact.associationChange",
      "resource": "contact",
      "description": "An association is added to or removed from a contact",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/hubspot/events#contact.associationChange",
      "json": "https://hookdeck.com/webhooks/hubspot/events/contact-associationchange.json"
    },
    {
      "name": "contact.restore",
      "resource": "contact",
      "description": "A deleted contact is restored",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/hubspot/events#contact.restore",
      "json": "https://hookdeck.com/webhooks/hubspot/events/contact-restore.json"
    },
    {
      "name": "contact.privacyDeletion",
      "resource": "contact",
      "description": "A contact is deleted for privacy compliance",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/hubspot/events#contact.privacyDeletion",
      "json": "https://hookdeck.com/webhooks/hubspot/events/contact-privacydeletion.json"
    },
    {
      "name": "company.deletion",
      "resource": "company",
      "description": "A company is deleted",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/hubspot/events#company.deletion",
      "json": "https://hookdeck.com/webhooks/hubspot/events/company-deletion.json"
    },
    {
      "name": "company.associationChange",
      "resource": "company",
      "description": "An association is added to or removed from a company",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/hubspot/events#company.associationChange",
      "json": "https://hookdeck.com/webhooks/hubspot/events/company-associationchange.json"
    },
    {
      "name": "company.restore",
      "resource": "company",
      "description": "A deleted company is restored",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/hubspot/events#company.restore",
      "json": "https://hookdeck.com/webhooks/hubspot/events/company-restore.json"
    },
    {
      "name": "company.merge",
      "resource": "company",
      "description": "Two companies are merged into one",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/hubspot/events#company.merge",
      "json": "https://hookdeck.com/webhooks/hubspot/events/company-merge.json"
    },
    {
      "name": "deal.deletion",
      "resource": "deal",
      "description": "A deal is deleted",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/hubspot/events#deal.deletion",
      "json": "https://hookdeck.com/webhooks/hubspot/events/deal-deletion.json"
    },
    {
      "name": "deal.associationChange",
      "resource": "deal",
      "description": "An association is added to or removed from a deal",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/hubspot/events#deal.associationChange",
      "json": "https://hookdeck.com/webhooks/hubspot/events/deal-associationchange.json"
    },
    {
      "name": "deal.restore",
      "resource": "deal",
      "description": "A deleted deal is restored",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/hubspot/events#deal.restore",
      "json": "https://hookdeck.com/webhooks/hubspot/events/deal-restore.json"
    },
    {
      "name": "deal.merge",
      "resource": "deal",
      "description": "Two deals are merged into one",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/hubspot/events#deal.merge",
      "json": "https://hookdeck.com/webhooks/hubspot/events/deal-merge.json"
    },
    {
      "name": "ticket.deletion",
      "resource": "ticket",
      "description": "A ticket is deleted",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/hubspot/events#ticket.deletion",
      "json": "https://hookdeck.com/webhooks/hubspot/events/ticket-deletion.json"
    },
    {
      "name": "ticket.propertyChange",
      "resource": "ticket",
      "description": "A subscribed property changes on a ticket",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/hubspot/events#ticket.propertyChange",
      "json": "https://hookdeck.com/webhooks/hubspot/events/ticket-propertychange.json"
    },
    {
      "name": "ticket.associationChange",
      "resource": "ticket",
      "description": "An association is added to or removed from a ticket",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/hubspot/events#ticket.associationChange",
      "json": "https://hookdeck.com/webhooks/hubspot/events/ticket-associationchange.json"
    },
    {
      "name": "ticket.restore",
      "resource": "ticket",
      "description": "A deleted ticket is restored",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/hubspot/events#ticket.restore",
      "json": "https://hookdeck.com/webhooks/hubspot/events/ticket-restore.json"
    },
    {
      "name": "ticket.merge",
      "resource": "ticket",
      "description": "Two tickets are merged into one",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/hubspot/events#ticket.merge",
      "json": "https://hookdeck.com/webhooks/hubspot/events/ticket-merge.json"
    },
    {
      "name": "product.creation",
      "resource": "product",
      "description": "A new product is created",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/hubspot/events#product.creation",
      "json": "https://hookdeck.com/webhooks/hubspot/events/product-creation.json"
    },
    {
      "name": "product.deletion",
      "resource": "product",
      "description": "A product is deleted",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/hubspot/events#product.deletion",
      "json": "https://hookdeck.com/webhooks/hubspot/events/product-deletion.json"
    },
    {
      "name": "product.restore",
      "resource": "product",
      "description": "A deleted product is restored",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/hubspot/events#product.restore",
      "json": "https://hookdeck.com/webhooks/hubspot/events/product-restore.json"
    },
    {
      "name": "product.merge",
      "resource": "product",
      "description": "Two products are merged into one",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/hubspot/events#product.merge",
      "json": "https://hookdeck.com/webhooks/hubspot/events/product-merge.json"
    },
    {
      "name": "product.propertyChange",
      "resource": "product",
      "description": "A subscribed property changes on a product",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/hubspot/events#product.propertyChange",
      "json": "https://hookdeck.com/webhooks/hubspot/events/product-propertychange.json"
    },
    {
      "name": "line_item.creation",
      "resource": "line_item",
      "description": "A new line item is created",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/hubspot/events#line_item.creation",
      "json": "https://hookdeck.com/webhooks/hubspot/events/line-item-creation.json"
    },
    {
      "name": "line_item.deletion",
      "resource": "line_item",
      "description": "A line item is deleted",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/hubspot/events#line_item.deletion",
      "json": "https://hookdeck.com/webhooks/hubspot/events/line-item-deletion.json"
    },
    {
      "name": "line_item.associationChange",
      "resource": "line_item",
      "description": "An association is added to or removed from a line item",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/hubspot/events#line_item.associationChange",
      "json": "https://hookdeck.com/webhooks/hubspot/events/line-item-associationchange.json"
    },
    {
      "name": "line_item.restore",
      "resource": "line_item",
      "description": "A deleted line item is restored",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/hubspot/events#line_item.restore",
      "json": "https://hookdeck.com/webhooks/hubspot/events/line-item-restore.json"
    },
    {
      "name": "line_item.merge",
      "resource": "line_item",
      "description": "Two line items are merged into one",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/hubspot/events#line_item.merge",
      "json": "https://hookdeck.com/webhooks/hubspot/events/line-item-merge.json"
    },
    {
      "name": "line_item.propertyChange",
      "resource": "line_item",
      "description": "A subscribed property changes on a line item",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/hubspot/events#line_item.propertyChange",
      "json": "https://hookdeck.com/webhooks/hubspot/events/line-item-propertychange.json"
    },
    {
      "name": "conversation.creation",
      "resource": "conversation",
      "description": "A new conversation thread is created",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/hubspot/events#conversation.creation",
      "json": "https://hookdeck.com/webhooks/hubspot/events/conversation-creation.json"
    },
    {
      "name": "conversation.deletion",
      "resource": "conversation",
      "description": "A conversation thread is archived or soft-deleted",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/hubspot/events#conversation.deletion",
      "json": "https://hookdeck.com/webhooks/hubspot/events/conversation-deletion.json"
    },
    {
      "name": "conversation.privacyDeletion",
      "resource": "conversation",
      "description": "A conversation thread is permanently deleted",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/hubspot/events#conversation.privacyDeletion",
      "json": "https://hookdeck.com/webhooks/hubspot/events/conversation-privacydeletion.json"
    },
    {
      "name": "conversation.propertyChange",
      "resource": "conversation",
      "description": "A property on a conversation thread changes",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/hubspot/events#conversation.propertyChange",
      "json": "https://hookdeck.com/webhooks/hubspot/events/conversation-propertychange.json"
    },
    {
      "name": "conversation.newMessage",
      "resource": "conversation",
      "description": "A new message arrives on a conversation thread",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/hubspot/events#conversation.newMessage",
      "json": "https://hookdeck.com/webhooks/hubspot/events/conversation-newmessage.json"
    },
    {
      "name": "object.creation",
      "resource": "object",
      "description": "A record of the subscribed object type is created",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/hubspot/events#object.creation",
      "json": "https://hookdeck.com/webhooks/hubspot/events/object-creation.json"
    },
    {
      "name": "object.deletion",
      "resource": "object",
      "description": "A record of the subscribed object type is deleted",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/hubspot/events#object.deletion",
      "json": "https://hookdeck.com/webhooks/hubspot/events/object-deletion.json"
    },
    {
      "name": "object.merge",
      "resource": "object",
      "description": "Two records of the subscribed object type are merged",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/hubspot/events#object.merge",
      "json": "https://hookdeck.com/webhooks/hubspot/events/object-merge.json"
    },
    {
      "name": "object.restore",
      "resource": "object",
      "description": "A deleted record of the subscribed object type is restored",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/hubspot/events#object.restore",
      "json": "https://hookdeck.com/webhooks/hubspot/events/object-restore.json"
    },
    {
      "name": "object.propertyChange",
      "resource": "object",
      "description": "A subscribed property changes on a record of that type",
      "confidence": "documented",
      "schema_source": "from HubSpot docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/hubspot/events#object.propertyChange",
      "json": "https://hookdeck.com/webhooks/hubspot/events/object-propertychange.json"
    },
    {
      "name": "object.associationChange",
      "resource": "object",
      "description": "An association on a record of that type is added or removed",
      "confidence": "documented",
      "schema_source": "from HubSpot docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/hubspot/events#object.associationChange",
      "json": "https://hookdeck.com/webhooks/hubspot/events/object-associationchange.json"
    }
  ]
}