Webhooks
Event Types
Understand PinBridge webhook payloads and lifecycle semantics.
Overview
PinBridge emits deterministic event types with payloads that include IDs required for lookups and reconciliation.
What You Will Learn
- Current event set and expected payload fields.
- How to map event types to user-visible status updates.
- Designing idempotent event handlers.
Implementation Checklist
- Handle pin.published and pin.failed as first-class states in your app.
- Store delivery ID and event type for auditability.
- Fetch latest pin state when payload context is insufficient.
Relevant Endpoints
GET
/v1/pins/{pin_id}Use for reconciliation after consuming events.