Changelog
Back to All
Added

New webhook events, order & assignment read endpoints

3 days ago by Daniel Druchleben

We've expanded the BKBN Sync API with new webhook events, new read endpoints, and refreshed webhook management.

New webhook events

The Sync API now emits six additional events (previously only VISUALS_READY):

  • PHOTOGRAPHER_BOOKED: a creative has accepted an assignment.
  • ORDER_STATUS_UPDATED: an order changed status.
  • ASSIGNMENT_STATUS_UPDATED: an assignment changed status.
  • APPOINTMENT_DATE_UPDATED: an assignment's shooting appointment date changed.
  • ESTIMATED_DELIVERY_UPDATED: an assignment's estimated delivery date changed.
  • MARKETING_MATERIALS_READY: marketing materials for a property are ready.

Each enabled webhook receives every event; switch on the event field (or the X-Event-Type header) to handle the ones you need. See the Webhooks guide for payloads and the new order and assignment status lifecycle diagrams.

New read endpoints

Fetch the enriched, current state after receiving an event:

  • GET /v1/orders/{orderPublicId}: order detail.
  • GET /v1/orders/{orderPublicId}/assignments: every assignment in an order.
  • GET /v1/assignments/{assignmentId}: assignment and delivery detail.

Webhook management

New management endpoints under /v1/webhooks let you retrieve, create or replace, enable or disable, and delete your webhook, plus view recent delivery history. The legacy /webhook/* endpoints are now deprecated and will be removed on 2026-09-10; please migrate to /v1/webhooks.