---
title: "Get a webhook by ID"
method: GET
path: "/webhooks/{webhook_id}"
tags: ["Webhooks"]
---

# Get a webhook by ID

`GET /webhooks/{webhook_id}`

Use this endpoint to retrieve a specific webhook by ID.

## Path parameters

- `webhook_id` integer, required

## Headers

- `x-oneflow-api-token` string, required
- `x-oneflow-user-email` string, email

## Response `200`

Returns the requested webhook.

- object — A webhook.
  - `callback_url` string, nullable, required — The webhook's callback url.
  - `configuration` object — Webhook configuration
    - `enable_draft_events` boolean — True if receiving webhooks for draft events
  - `filters` object[], nullable, required — An array of filters associated with the webhook.
    - `filter_rules` union[], required
      - union
        - object — This represents an event type filter rule which can be associated with a webhook filter.
          - `type` 'EVENT_TYPE', required — The type of the rule.
          - `values` string[], required — The types of events we want.
        - object — This represents a workspace filter rule which can be associated with a webhook filter.
          - `type` 'WORKSPACE', required — The type of the rule.
          - `values` integer[], required — The workspace IDs we want events for.
        - object — This represents an integration blueprint filter rule which can be associated with a webhook filter.
          - `type` 'BLUEPRINT', required — The type of the rule.
          - `values` integer[], required — The integration blueprint IDs we want events for.
  - `integration_instance` integer, nullable, required — Connected integration instance.
  - `integration_process_id` integer, nullable, required — This is a feature for the future, and the default value is `null`.
  - `legacy_webhook` boolean, required — True if the webhook is a legacy webhook.
  - `template_group_id` integer, nullable, required
  - `webhook_id` integer, required — webhook ID

## Other responses

- `400` — Invalid format or content of the request.
- `401` — The API token or the user email is invalid.
- `403` — The request is not authorized by the server.
- `404` — A required entity is missing.

---

[API](https://skmtc.net/oneflow/apis/public-api-for-oneflow.md) · [All operations](https://skmtc.net/oneflow/apis/public-api-for-oneflow/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oneflow/public-api-for-oneflow/versions/0e73a45dec15/schema)