Skip to main content
POST
/
v2
/
notifications
/
webhooks
/
{webhook_id}
/
activate
Activate Webhook Subscription
curl --request POST \
  --url https://api.catenatelematics.com/v2/notifications/webhooks/{webhook_id}/activate \
  --header 'Authorization: Bearer <token>'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "url": "<unknown>",
  "secret": "<unknown>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "filters": {
    "fleet_ids": [
      "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    ],
    "fleet_refs": [
      "<string>"
    ]
  }
}

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

​
webhook_id
string<uuid>
required

Response

Successful Response

Webhook read model

Redact sensitive fields by default.

​
id
string<uuid>
required

The unique identifier of the webhook subscription

​
url
any
required

The target URL where webhook events are delivered. Partially redacted for security.

​
event_name
enum<string>
required

The event name that triggers this webhook

Available options:
dvir_log.added,
dvir_log.modified,
dvir_log.removed,
dvir_log.*,
driver_vehicle_association.added,
driver_vehicle_association.modified,
driver_vehicle_association.*,
trailer_vehicle_association.added,
trailer_vehicle_association.modified,
trailer_vehicle_association.*,
invitation.created,
invitation.rejected,
invitation.declined,
invitation.viewed,
invitation.sent,
invitation.accepted,
invitation.expired,
invitation.deleted,
invitation.*,
connection.created,
connection.staled,
connection.*,
fleet_connection.created,
fleet_connection.*,
fleet_info.added,
fleet_info.modified,
fleet_info.removed,
fleet_info.*,
share_agreement.created,
share_agreement.updated,
share_agreement.deleted,
share_agreement.*,
webhook.created,
webhook.updated,
webhook.deleted,
webhook.staled,
webhook.activated,
webhook.paused,
webhook.*,
workflow.added,
workflow.modified,
workflow.removed,
workflow.*,
tsp.created,
tsp.requested,
vehicle.added,
vehicle.modified,
vehicle.removed,
vehicle.*,
trailer.added,
trailer.modified,
trailer.removed,
trailer.*,
trailer_location.added,
trailer_location.modified,
trailer_location.*,
trailer_status.added,
trailer_status.modified,
trailer_status.*,
execution.created,
execution.staled,
execution.failed,
execution.*,
schedule.deactivated,
schedule.*,
user.added,
user.modified,
user.removed,
user.*,
vehicle_location.added,
vehicle_location.*,
ifta_summary.added,
ifta_summary.modified,
ifta_summary.removed,
ifta_summary.*,
hos_availability.added,
hos_availability.modified,
hos_availability.removed,
hos_availability.*,
hos_daily_snapshot.added,
hos_daily_snapshot.modified,
hos_daily_snapshot.removed,
hos_daily_snapshot.*,
hos_event.added,
hos_event.modified,
hos_event.removed,
hos_event.*,
hos_violation.added,
hos_violation.modified,
hos_violation.removed,
hos_violation.*,
engine_log.added,
engine_log.modified,
engine_log.removed,
engine_log.*,
engine_status.added,
engine_status.modified,
engine_status.*,
group_message.added,
group_message.modified,
group_message.*,
message.added,
message.modified,
message.*,
fuel_transaction.added,
fuel_transaction.modified,
fuel_transaction.*,
resource_operation.created,
resource_operation.succeeded,
resource_operation.failed,
resource_operation.*
​
secret
any
required

The secret key used to sign webhook messages. Redacted for security.

​
status
enum<string>
required

The current status of the webhook subscription (active, inactive, stale, or deleted)

Available options:
active,
paused,
stale,
deleted
​
created_at
string<date-time>
required

The timestamp when the webhook subscription was created

​
updated_at
string<date-time>
required

The timestamp when the webhook subscription was last updated

​
filters
WebhookFilters · object

Webhook filters