v2.35.0

Released 7th August 2026

Document Webhook Events

This release expands the webhook notification system with support for document lifecycle events, enabling integrations to react to document additions, modifications, and any document-related activity.

Backward-compatible addition: All new event types are additive. Existing webhook subscriptions and integrations are unaffected.

New webhook event types

Document events

Three new values have been added to the WebhookEventNameEnum, available across all webhook endpoints:

Event name	Description
`document.added`	Fires when a new document is added
`document.modified`	Fires when an existing document is modified
`document.*`	Wildcard — fires on any document event

You can now subscribe to document events when creating or updating a webhook:

# Subscribe to all document events using the wildcard
POST /v2/notifications/webhooks
Content-Type: application/json

{
  "event_name": "document.*",
  "url": "https://your-endpoint.example.com/webhook"
}

# Subscribe to document additions only
POST /v2/notifications/webhooks
Content-Type: application/json

{
  "event_name": "document.added",
  "url": "https://your-endpoint.example.com/webhook"
}

You can also filter existing webhooks by the new event types:

GET /v2/notifications/webhooks?event_name=document.added
GET /v2/notifications/webhooks?event_name=document.modified
GET /v2/notifications/webhooks?event_name=document.*

Affected endpoints

The new event types are available on all webhook management endpoints:

GET /v2/notifications/webhooks — filter by new event names
POST /v2/notifications/webhooks — subscribe to new event names
GET /v2/notifications/webhooks/{webhook_id} — response includes new enum values
PATCH /v2/notifications/webhooks/{webhook_id} — update subscription to new event names
POST /v2/notifications/webhooks/{webhook_id}/activate — response includes new enum values
POST /v2/notifications/webhooks/{webhook_id}/pause — response includes new enum values
GET /v2/notifications/webhooks/{webhook_id}/logs — log entries include new event names

Driver Safety Event URLs

This release adds a new urls field to driver safety event schemas, giving you direct access to associated media and resource links within safety event payloads.

Backward-Compatible Addition: All existing integrations continue to work without changes. The new urls field is additive and optional.

Schema Changes

Driver safety event schemas

A new urls property has been added to the following schemas:

BaseDriverSafetyEvent
DriverSafetyEventAdded
DriverSafetyEventModified

The urls field provides a list of URLs associated with the safety event — for example, links to video clips, images, or other media captured during the event.Example response (new field highlighted):

{
  "event_type": "driver_safety_event.added",
  "data": [
    {
      "id": "evt_123",
      "driver_id": "drv_456",
      "event_time": "2026-08-07T10:00:00Z",
      "severity": "high",
      "urls": [
        "https://media.example.com/safety/clip_001.mp4",
        "https://media.example.com/safety/thumb_001.jpg"
      ]
    }
  ]
}

Affected webhook events

Schema	Change
`BaseDriverSafetyEvent`	New `urls` property added
`DriverSafetyEventAdded`	New `urls` property added to items in `data` array
`DriverSafetyEventModified`	New `urls` property added to items in `data` array

Driver Safety Event Webhooks

This release adds webhook support for driver safety events, enabling real-time notifications when safety events are created, updated, or removed in the Catena platform.

New Feature: Three new webhook event types cover the full lifecycle of driver safety events — added, modified, and removed — along with a catch-all wildcard subscription.

New webhook events

driver_safety_event.added

Emitted when a new driver safety event is added to the database — for example, when a record fetched from the TSP is new and generates a new entry in Catena.Event name: driver_safety_event.addedPayload schema: DriverSafetyEventAdded

# Subscribe to driver safety event additions
POST /v2/notifications/webhooks
{
  "url": "https://your-endpoint.example.com/webhooks",
  "event_name": "driver_safety_event.added"
}

driver_safety_event.modified

Emitted when a driver safety event is modified in the database — for example, when a record fetched from the TSP differs from what was previously stored and prompts an update.Event name: driver_safety_event.modifiedPayload schema: DriverSafetyEventModified

# Subscribe to driver safety event modifications
POST /v2/notifications/webhooks
{
  "url": "https://your-endpoint.example.com/webhooks",
  "event_name": "driver_safety_event.modified"
}

driver_safety_event.removed

Emitted when a driver safety event is removed from the database — for example, when a record is deleted from the TSP and removed from Catena.Event name: driver_safety_event.removedPayload schema: DriverSafetyEventRemoved

# Subscribe to driver safety event removals
POST /v2/notifications/webhooks
{
  "url": "https://your-endpoint.example.com/webhooks",
  "event_name": "driver_safety_event.removed"
}

driver_safety_event.* (catch-all)

Subscribe to all driver safety event lifecycle events with a single wildcard subscription.Event name: driver_safety_event.*

# Subscribe to all driver safety events
POST /v2/notifications/webhooks
{
  "url": "https://your-endpoint.example.com/webhooks",
  "event_name": "driver_safety_event.*"
}

Updated endpoints

The event_name field across all webhook endpoints now accepts the new driver_safety_event.* values. No changes are required to existing webhook subscriptions — this is a purely additive update.

Endpoint	Change
`GET /v2/notifications/webhooks`	`event_name` filter accepts new values
`POST /v2/notifications/webhooks`	`event_name` field accepts new values
`GET /v2/notifications/webhooks/{webhook_id}`	Response `event_name` includes new values
`PATCH /v2/notifications/webhooks/{webhook_id}`	`event_name` field accepts new values
`POST /v2/notifications/webhooks/{webhook_id}/activate`	Response `event_name` includes new values
`POST /v2/notifications/webhooks/{webhook_id}/pause`	Response `event_name` includes new values
`GET /v2/notifications/webhooks/{webhook_id}/logs`	Response `event_name` includes new values

Overview

Authentication

Telematics

Organizations

Integrations

Notifications

Intelligence

Document Webhook Events

New webhook event types

Affected endpoints

Driver Safety Event URLs

Schema Changes

Affected webhook events

Driver Safety Event Webhooks

New webhook events

Updated endpoints

Need help?

Webhook documentation

Contact support

​Document Webhook Events

​New webhook event types

​Affected endpoints

​Driver Safety Event URLs

​Schema Changes

​Affected webhook events

​Driver Safety Event Webhooks

​New webhook events

​Updated endpoints

​Need help?

Webhook documentation

Contact support

Document Webhook Events

New webhook event types

Affected endpoints

Driver Safety Event URLs

Schema Changes

Affected webhook events

Driver Safety Event Webhooks

New webhook events

Updated endpoints

Need help?