Dealhubio Webhooks

generated: '2026-10-22'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://developers.dealhub.io/docs/webhooks-overview.md
sources:
- https://developers.dealhub.io/docs/webhooks-overview.md
- https://developers.dealhub.io/docs/how-to-configure-webhooks.md
- https://developers.dealhub.io/docs/quote-webhook-events-reference.md
- https://developers.dealhub.io/docs/version-user-webhook-events-reference.md
description: DealHub webhooks deliver JSON payloads via HTTP POST to a configured HTTPS endpoint. Authentication is performed using an Authorization
  header (Bearer token, Basic auth, or none). No signature header or retry policy is documented.
events:
- event: draftQuote
  description: Published when a user creates a quote and saves it as a draft, or modifies an existing draft.
- event: primaryQuote
  description: Published when a user or system marks a specific quote as the "Primary" quote.
- event: quotePendingApproval
  description: Published when a user submits a quote that requires approval, and each time an approver approves their part of the flow.
- event: quoteReady
  description: Published when a quote is ready to be shared with the customer, either after full approval or when no approval is required.
- event: quoteRejected
  description: Published when an approver rejects the quote.
- event: quoteRecalled
  description: Published when a user explicitly requests to cancel (recall) the quote.
- event: quotePublished
  description: Published when the quote is published to a DealRoom.
- event: quoteUnpublished
  description: Published if a user unpublishes the DealRoom.
- event: quoteWon
  description: Published when the quote is signed (either via DealRoom or externally).
- event: version
  description: Published for version lifecycle actions; the payload includes an `action` field (`created`, `activated`, `reactivated`).
- event: user
  description: Published for user lifecycle actions; the payload includes an `action` field (`created`, `modified`, `deleted`).
- event: productsUpload
  description: Published when an SFTP product file upload or Open API upload is completed, indicating success or error.
- event: Failure WebHook v1
  description: Published if the system fails to execute an asynchronous API request.
- event: crmImport
  description: Published when a CRM import request completes, providing counts of total, succeeded, failed, and skipped records.
delivery:
  auth: Authorization header (Bearer token, Basic auth, or none)
docs: https://developers.dealhub.io/docs/webhooks-overview.md