---
title: "List Webhooks"
method: GET
path: "/api/v1/webhooks"
tags: ["Webhooks", "Public API"]
---

# List Webhooks

`GET /api/v1/webhooks`

Returns all webhooks owned by the authenticated user. Each entry is a summary with the webhook's ID, name, URL, creation datetime, and last-fired datetime. Returns an empty array when no webhooks exist. Use "Get Webhook" to retrieve the full configuration of a specific webhook, including monitored fields and post fields when applicable, and events.

OAuth Scopes: webhooks

## Response `200`

An object with a `webhooks` array containing one summary entry per webhook owned by the authenticated user.

- object
  - `webhooks` object[]
    - `id` string — The ID of the webhook.
    - `name` string — The name of the webhook.
    - `created` string — Datetime when the webhook was created (UTC, format: YYYY-MM-DD HH:MM:SS).
    - `lastSent` string, nullable — Datetime when the webhook was last fired (UTC, format: YYYY-MM-DD HH:MM:SS). Null if the webhook has never fired.
    - `url` string — The URL the webhook sends data to.

## Other responses

- `401` — Unauthorized. No response body is returned.
- `403` — The authenticated user does not have permission to access webhooks.
- `500` — Internal server error.

---

[API](https://skmtc.net/bamboohr/apis/bamboohr-api.md) · [All operations](https://skmtc.net/bamboohr/apis/bamboohr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bamboohr/bamboohr-api/revisions/19ebf391a399/schema)