---
title: "List Webhook V2"
method: GET
path: "/v2/webhooks"
tags: ["Webhooks"]
---

# List Webhook V2

`GET /v2/webhooks`

## Response `200`

Webhooks retrieved

- WebhookV2Object[]
  - `id` string, required — The ID of the Webhook V2 object.
  - `url` string, required — Proof will make a POST request to this URL for every subscribed event.
  - `header` string, nullable — A header value to pass through every request Proof makes back to your webhook URL. This can be required authentication to your system for security purposes. (E.g. "header": "X-Custom-Header:X-Custom-Key")
  - `headers` string[] — A list of header values to pass through every request Proof makes back to your webhook URL. This can be required authentication to your system for security purposes. (E.g. "headers": ["[X-Custom-Header]:[X-Custom-Key]"])
  - `enabled` boolean, required — A boolean value to indicate if the webhook is active.
  - `request_id_header_name` string — The name of the header that will contain the request ID for each webhook request. Defaults to X-Request-Id.
  - `request_id_header_value_template` string, nullable
  - `oauth` object
    - `enabled` boolean
    - `token_url` string, nullable
    - `client_id` string, nullable
  - `subscriptions` string[], required — An array containing the desired events that Proof should POST a webhook for. See our [Webhooks V2 guide](https://dev.proof.com/docs/webhooks-v2) for a list of valid subscriptions.

---

[API](https://skmtc.dev/proof/apis/proof-business-api-specification.md) · [All operations](https://skmtc.dev/proof/apis/proof-business-api-specification/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/proof/proof-business-api-specification/revisions/1adaa0ea25cd/schema)