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

# List Monitor Fields

`GET /api/v1/webhooks/monitor_fields`

Returns the list of employee fields that can be monitored by a webhook. Monitor fields are only applicable to webhooks that use update events (`employee.updated` or `employee_with_fields.updated`). Use the field IDs or aliases from this response in the `monitorFields` array when creating or updating a webhook via Create Webhook or Update Webhook.

OAuth Scopes: webhooks

## Response `200`

An object with a `fields` array containing one entry per monitorable employee field, including the field ID (as a string), human-readable name, and alias (null if no alias is defined).

- object
  - `fields` object[], required — The list of employee fields available for webhook monitoring.
    - `id` string, required — The field ID, returned as a string.
    - `name` string, required — The human-readable field name.
    - `alias` string, nullable, required — The field alias used in the BambooHR API (e.g. `firstName`). Null if no alias is defined for this field.

## Other responses

- `401` — Unauthorized.
- `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)