---
title: "List webhook event"
method: GET
path: "/api/v2/webhook-events"
tags: ["WebhookEvent"]
---

# List webhook event

`GET /api/v2/webhook-events`

Requires one of the following scopes: `webhook_events:read`, `webhook_events:all`, `all:read`, `all:all`

## Query parameters

- `limit` integer
- `starting_after` string
- `success` boolean
- `from` string, date
- `to` string, date
- `search` string

## Response `200`

The list of Webhook Event

- object
  - `items` WebhookEvent[], required — The list of Webhook Event
    - `id` string, uuid, required — Unique identifier for the webhook event (UUID)
    - `timestamp_created` string, date-time, required — Timestamp when the webhook event was created
    - `timestamp_created_date` string, date, required — Date when the webhook event was created (for partitioning)
    - `organization_id` string, uuid, required — Organization (workspace) UUID that owns this webhook event
    - `payload` object — JSON payload that was sent/attempted to be sent
    - `success` boolean, required — Whether the webhook call was successful
    - `retry_count` number, required — Number of retry attempts made
    - `will_retry` boolean, required — Whether the webhook will be retried
    - `webhook_url` string, required — Target URL where the webhook was sent
    - `status_code` number, nullable — HTTP status code received from the webhook endpoint (if any)
    - `error_message` string, nullable — Error message if the webhook failed
    - `timestamp_next_retry` string, date-time, nullable — Timestamp for the next retry attempt (if applicable)
    - `retry_group_id` string, uuid, nullable — UUID for grouping retry attempts
    - `retry_successful` boolean, nullable — Whether the retry was successful (for retry events)
    - `lead_email` string, nullable — Email address of the lead associated with this webhook event
    - `response_time_ms` number, nullable — Response time in milliseconds for the webhook call
  - `next_starting_after` string — The filter for getting the next items after this one, this could either be a UUID, a timestamp, on an email depending on the specific API

## Other responses

- `401` — This request is unauthorized (either the Authorization header is missing or invalid, or the API key has been revoked)
- `402` — This request cannot be fulfilled because the workspace does not have an active paid plan
- `404` — The requested resource was not found
- `429` — You have exceeded the rate limit. Please check the rate limit docs for more information.

---

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