Retrieve a webhook with given ID

Retrieve a webhook with given ID.

Rate limit: 5 requests/sec (learn more about rate limits here).

To use this endpoint, select Read Webhooks under the Setup & Administration category when creating or editing an API token. Learn More.

Submit Feedback: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team.

GET /webhooks/{id}

Retrieve a webhook with given ID

cURL

curl --request GET \
  --url https://api.samsara.com/webhooks/{id} \
  --header 'Authorization: Bearer <token>'

200

{
  "id": "23918",
  "name": "Webhook-123",
  "secretKey": "11121-31231-1231212",
  "url": "https://www.webhook-123.com/webhook/listener",
  "version": "2018-01-01",
  "customHeaders": [
    {
      "key": "format",
      "value": "xcmol-532"
    }
  ],
  "eventTypes": [
    "AddressCreated",
    "AddressCreated",
    "AddressCreated",
    "AddressCreated"
  ]
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id · string · required

ID of the webhook. This is the Samsara-specified ID.

Response

200

application/json

OK response.

id · string · required

The ID of the webhook. This will appear in both Samsara’s cloud dashboard and the API. This is the id of the webhook. This is system generated.

Example:

"23918"

name · string · required

The name of the webhook. This will appear in both Samsara’s cloud dashboard and the API. It can be set or updated through the Samsara Dashboard or through the API at any time.

Example:

"Webhook-123"

secretKey · string · required

The secret key of the webhook. This will appear in both Samsara’s cloud dashboard and the API.

Example:

"11121-31231-1231212"

url · string · required

The url of the webhook. This will appear in both Samsara’s cloud dashboard and the API. It can be set or updated through the Samsara Dashboard or through the API at any time.

Example:

"https://www.webhook-123.com/webhook/listener"

version · enum<string> · required

The version of the webhook. Valid values: 2018-01-01, 2021-06-09

Available options: 2018-01-01, 2021-06-09

Example:

"2018-01-01"

customHeaders · object[]

The list of custom headers that users can include with their request

Maximum array length: 5

Show child attributes

eventTypes · enum<string>[]

The list of event types associated with a particular webhook.

This is the name of the event type. Valid values: AddressCreated, AddressDeleted, AddressUpdated, AlertIncident, AlertObjectEvent, DocumentSubmitted, DriverCreated, DriverUpdated, DvirSubmitted, EngineFaultOff, EngineFaultOn, FormSubmitted, FormUpdated, GatewayUnplugged, GeofenceEntry, GeofenceExit, IssueCreated, MissingDvirPastDue, PredictiveMaintenanceAlert, RouteStopArrival, RouteStopDeparture, RouteStopEarlyLateArrival, RouteStopEtaUpdated, RouteStopResequence, SevereSpeedingEnded, SevereSpeedingStarted, SpeedingEventEnded, SpeedingEventStarted, SuddenFuelLevelDrop, SuddenFuelLevelRise, VehicleCreated, VehicleUpdated

Available options: AddressCreated, AddressDeleted, AddressUpdated, AlertIncident, AlertObjectEvent, DocumentSubmitted, DriverCreated, DriverUpdated, DvirSubmitted, EngineFaultOff, EngineFaultOn, FormSubmitted, FormUpdated, GatewayUnplugged, GeofenceEntry, GeofenceExit, IssueCreated, MissingDvirPastDue, PredictiveMaintenanceAlert, RouteStopArrival, RouteStopDeparture, RouteStopEarlyLateArrival, RouteStopEtaUpdated, RouteStopResequence, SevereSpeedingEnded, SevereSpeedingStarted, SpeedingEventEnded, SpeedingEventStarted, SuddenFuelLevelDrop, SuddenFuelLevelRise, VehicleCreated, VehicleUpdated

Example:

[
  "AddressCreated",
  "AddressCreated",
  "AddressCreated",
  "AddressCreated"
]