Buildworkpro Com Webhooks

generated: '2026-11-03'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://buildworkpro.com/api/webhooks/events/
sources:
- https://buildworkpro.com/api/webhooks/events/
- https://buildworkpro.com/api/webhooks/overview/
- https://buildworkpro.com/api/webhooks/signatures/
- https://buildworkpro.com/api/webhooks/testing/
description: BuildWorkPro webhooks deliver JSON envelopes via HTTPS POSTs. Each delivery includes a BuildWorkPro-Signature header (HMAC‑SHA256
  of <timestamp>.<rawBody>), a BuildWorkPro-Event header with the event type, and a BuildWorkPro-Event-Id header for idempotency.
events:
- event: bid.created
  description: Fires when a new bid row is inserted.
- event: bid.accepted
  description: Fires when POST /api/v1/bids/{id}/accept succeeds and the bid transitions to accepted.
- event: bid.rejected
  description: Fires when POST /api/v1/bids/{id}/reject succeeds and the bid transitions to rejected.
- event: project.created
  description: Fires when a project is inserted.
- event: project.status_changed
  description: Fires only when the project status field actually changes; includes previous_attributes.
- event: pay_app.submitted
  description: Fires when POST /api/v1/pay-apps/{id}/submit succeeds and the pay app moves out of draft.
- event: pay_app.approved
  description: Fires when POST /api/v1/pay-apps/{id}/approve succeeds and the pay app is approved.
- event: change_order.submitted
  description: Fires when a change order transitions from draft to submitted.
- event: change_order.approved
  description: Fires when a change order is approved after the transaction commits.
- event: contact.created
  description: Fires when a contact is inserted via the API or dashboard.
delivery:
  retries: Best‑effort with up to seven attempts on a back‑off schedule (≈30 s, 2 min, 15 min, 1 h, 6 h, 24 h) with jitter. Permanent 4xx (except
    408 and 429) stop retries immediately. After 20 consecutive failures the endpoint is disabled until re‑enabled.
docs: https://buildworkpro.com/api/webhooks/events/