---
title: "Get the webhooks health status"
method: GET
path: "/v1/webhooks/health_check"
tags: ["Webhooks"]
---

# Get the webhooks health status

`GET /v1/webhooks/health_check`

Returns the health status (`healthy`, `unhealthy`, or `unknown`) of the webhooks system based on the last ten minutes of activity.

📘 System Access Authentication

This endpoint uses the [Bearer Auth scheme with the system-level access token in the HTTP Authorization header](https://docs.gusto.com/embedded-payroll/docs/system-access)

scope: `webhook_subscriptions:read`

## Headers

- `X-Gusto-API-Version` '2026-06-15'

## Response `200`

successful

- WebhooksHealthCheckStatus — The representation of a webhooks health check response
  - `status` 'healthy' | 'unhealthy' | 'unknown' — Latest health status of the webhooks system
  - `last_checked_at` string, date-time — ISO8601 timestamp of the last successful health check with millisecond precision

---

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