---
title: "Get Event [Single]"
method: GET
path: "/apiHub/webhooks/v1/events/{id}"
tags: ["Events"]
---

# Get Event \[Single\]

`GET /apiHub/webhooks/v1/events/{id}`

## Request

- Base URL: `dc1demogwext.paylocity.com` (relative, and the document’s source URL is not known)
- URL: `dc1demogwext.paylocity.com/apiHub/webhooks/v1/events/{id}`
- Auth: HTTP bearer

> 🚧 Early Access API Version
> This endpoint version is currently in Early Access and available only to approved early adoption (EA) participants. Do not rely on this version for production workloads unless explicitly authorized. If you have any feedback, please share with your designated Early Adoption program representative.

**Summary Description**

 Retrieves a single webhook event by its unique `id`. Supports optional includes to retrieve the associated subscription details and delivery logs in a single request.

Use this endpoint to:

- Inspect the full details of a specific webhook event
- Retrieve delivery logs to diagnose failed or retried events
- Include subscription configuration alongside event data for audit or debugging purposes

## Path parameters

- `id` string, uuid, required

## Query parameters

- `include` string

## Headers

- `Authorization` string, required

## Response `200`

OK

- WebhookEventByIdV1Response: A single webhook event, with optional delivery logs and subscription details.
  - `id` string, uuid: The unique identifier of the webhook event.
  - `correlationId` string, uuid: A correlation identifier used to trace the event across systems.
  - `subscriptionId` string, uuid: The unique identifier of the subscription the event was delivered to.
  - `subscriptionName` string, nullable: The name of the subscription the event was delivered to.
  - `clientId` string, nullable: The ID of the API credentials that own the subscription.
  - `applicationId` string, uuid, nullable: The ID of the application associated with the API credentials.
  - `type` string, nullable: The event type (e.g. `employee.person.v1`, `employee.assignment.v1`).
  - `mutation` string, nullable: The type of change made to the resource (e.g. `created`, `updated`, `deleted`).
  - `time` string, date-time: The date and time the event occurred.
  - `dataContentType` string, nullable: The content type of the event payload.
  - `data` object, nullable: The event payload. Structure varies by event type.
  - `status` string, nullable: The delivery status of the event (e.g. `Delivered`, `Failed`, `Pending`).
  - `lastStatusCode` string, nullable: The HTTP status code returned by the most recent delivery attempt.
  - `totalAttempts` integer: The total number of delivery attempts made for the event.
  - `logs` WebhookEventLogV1Response[], nullable: Array of delivery attempt logs for the event. Returned when `include=logs` is specified.
    - `id` string, uuid: The unique identifier of the log entry.
    - `attemptNumber` integer: The delivery attempt number.
    - `responseCode` string, nullable: The HTTP status code returned by the webhook URL for this attempt.
    - `response` string, nullable: The response body returned by the webhook URL for this attempt.
    - `durationMs` integer: The duration of the delivery attempt in milliseconds.
    - `createdAt` string, date-time, nullable: The date and time the delivery attempt was made.
  - `subscription` ReadSubscriptionV1Model
    - `id` string, uuid: The unique identifier of the webhook subscription.
    - `clientId` string, uuid: The ID of the API credentials that own the subscription.
    - `applicationId` string, uuid: The ID of the application associated with the API credentials.
    - `name` string, nullable: The name of the webhook subscription.
    - `status` string, nullable: The current status of the webhook subscription. Allowable Values: ACTIVE, DISABLED, DEACTIVATED, UNREACHABLE, PENDING_VERIFICATION.
    - `eventTypes` string[], nullable: List of event types the subscription receives (e.g. `employee.person.v1`, `employee.assignment.v1`).
    - `url` string, nullable: The URL where webhook events are delivered.
    - `auth` ReadAuthV1Model: ### Authentication Configuration (Response) The API returns exactly one authentication object depending on the configured type: - **HMAC authentication** – the `hmac` object will be populated.
      - `type` string, required: The authentication type configured for the subscription. Allowable Values: HMAC.
      - `hmac` ReadHmacAuthV1Model
        - `key1` ReadHmacKeyV1Model, required
          - `keyId` string, uuid, required: The unique identifier of the HMAC key.
          - `issuedAt` string, date-time, required: The date and time the HMAC key was issued.
          - `expirationAt` string, date-time, required: The date and time the HMAC key expires.
        - `key2` ReadHmacKeyV1Model
          - `keyId` string, uuid, required: The unique identifier of the HMAC key.
          - `issuedAt` string, date-time, required: The date and time the HMAC key was issued.
          - `expirationAt` string, date-time, required: The date and time the HMAC key expires.
    - `createdAt` string, date-time, nullable: The date and time the subscription was created.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error

---

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