---
title: "List all webhooks belonging to a specific org."
method: GET
path: "/webhooks"
tags: ["Webhooks"]
---

# List all webhooks belonging to a specific org.

`GET /webhooks`

## Request

- Base URL: `https://api.samsara.com`
- URL: `https://api.samsara.com/webhooks`
- Auth: HTTP bearer

List all webhooks belonging to a specific org.

 <b>Rate limit:</b> 5 requests/sec (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).

To use this endpoint, select **Read Webhooks** under the Setup & Administration category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
 

 **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.

## Query parameters

- `ids` string
- `limit` integer
- `after` string

## Response `200`

OK response.

- WebhooksListWebhooksResponseBody
  - `data` WebhookResponseResponseBody[], required: This is a list of Webhooks.
    - `customHeaders` CustomHeadersObjectResponseBody[]: The list of custom headers that users can include with their request
      - `key` string, required: The alphanumeric key of the custom header.
      - `value` string, required: The value of the custom header. The default maximum length of the value is 100 characters.
    - `eventTypes` string[]: The list of event types associated with a particular webhook.
    - `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.
    - `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.
    - `secretKey` string, required: The secret key of the webhook. This will appear in both Samsara’s cloud dashboard and the API.
    - `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.
    - `version` '2018-01-01' | '2021-06-09', required: The version of the webhook. Valid values: `2018-01-01`, `2021-06-09`
  - `pagination` GoaPaginationResponseResponseBody, required: Pagination parameters.
    - `endCursor` string, required: Cursor identifier representing the last element in the response. This value should be used in conjunction with a subsequent request's 'after' query parameter. This may be an empty string if there are no more pages left to view.
    - `hasNextPage` boolean, required: True if there are more pages of results immediately available after this endCursor.

## Other responses

- `401`: Unauthorized response.
- `404`: Not Found response.
- `405`: Method Not Allowed response.
- `413`: Content Too Large response.
- `429`: Too Many Requests response.
- `500`: Internal Server Error response.
- `501`: Not Implemented response.
- `502`: Bad Gateway response.
- `503`: Service Unavailable response.
- `504`: Gateway Timeout response.
- `default`: Bad Request response.

---

[API](https://skmtc.dev/samsara/apis/samsara-api.md) - [All operations](https://skmtc.dev/samsara/apis/samsara-api/llms.txt) - [OpenAPI document](https://skmtc.dev/samsara/apis/samsara-api/revisions/a9e35d4999be?raw)