Skip to main content

Carrier Public API Webhook Changes

New Webhook Fields and Their Usage​

We've enhanced our Carrier public API webhook system with two important new fields and improved our documentation around webhook handling:

New Fields​

  1. guid - A unique identifier for each webhook event

    • Use this field to implement idempotency in your webhook handling
    • Store this ID to detect and handle duplicate webhook deliveries

  2. occurred_at - Timestamp when the event was processed by our system

    • Helps with event ordering and debugging
    • Format: ISO 8601 with timezone offset
Improved Webhook Handling​

We've expanded our documentation to provide clearer guidance on:

  • Duplicate Event Handling: How to use the new guid field to detect and handle duplicate webhook deliveries
  • Retry Logic: Understanding our webhook retry behavior
  • Event Ordering: How to use occurred_at to properly sequence events in your system

These changes will help you build more reliable webhook integrations and make it easier to debug issues when they arise.

For more details, please refer to our updated documentations.