Add Webhook Subscription to Multiple Event Types

Tested

PUT

/companies/{company_id}/webhook

Provide a URL for a call-back server to listen and receive webhook notifications sent by RoscoLive for the notification types(type_ids) subscribed to for the passed in company_id. More than one URL can be subscribed to the same notification types for the same company. Use the Delete Webhook Subscription endpoint to remove a webhook subscription from the company if it is no longer required.

Type	Type ID
Events and Alerts	0
Alerts	1
Events	2
Device Status (Connection Status)	3
Ignition State	4
Input Sensor	5
Unidentified Driver	6
Identified Driver	7
Channel Status (Bad Channel)	8

Request

Path Params

Body Params multipart/form-data

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'https://fleet.roscolive.com/api/v1.0/companies/1234/webhook' \
--form 'subscribe_url="https://prod-example-39.webhook.cool"' \
--form 'type_ids=""'

Responses

🟢200Success

application/json

Body

Example

{
    "meta": {
        "code": 200
    },
    "response": {
        "webhooks": [
            {
                "created_at": "2025-06-12 15:08:05",
                "id": 822,
                "notifications": 1,
                "url": "https://wh_example.com"
            },
            {
                "created_at": "2025-06-12 15:08:05",
                "id": 823,
                "notifications": 5,
                "url": "https://wh_example.com"
            }
        ]
    },
    "result": "OK"
}

🟠400Bad Request

🟠401Login Required

🟠404Resource Not Found

🔴500Internal Server Error

Modified at 2025-06-26 18:59:47

Webhooks

Get Notification Subscriptions for Event Type