---
title: "Get webhook subscription"
method: GET
path: "/webhook/webhooks/{id}"
tags: ["Webhooks"]
---

# Get webhook subscription

`GET /webhook/webhooks/{id}`

Get the webhook subscription details

## Path parameters

- `id` string, required

## Headers

- `x-apideck-app-id` string, required

## Response `200`

Webhooks

- GetWebhookResponse
  - `status_code` integer, required — HTTP Response Status Code
  - `status` string, required — HTTP Response Status
  - `data` Webhook, required
    - `id` string
    - `description` string, nullable — A description of the object.
    - `unified_api` 'accounting' | 'ats' | 'calendar' | 'crm' | 'csp' | 'customer-support' | 'ecommerce' | 'email' | 'email-marketing' | 'expense-management' | 'file-storage' | 'form' | 'hris' | 'lead' | 'payroll' | 'pos' | 'procurement' | 'project-management' | 'script' | 'sms' | 'spreadsheet' | 'subscription-analytics' | 'team-messaging' | 'issue-tracking' | 'time-registration' | 'transactional-email' | 'vault' | 'data-warehouse', required — Name of Apideck Unified API
    - `status` 'enabled' | 'disabled', required — The status of the webhook.
    - `disabled_reason` 'none' | 'retry_limit' | 'usage_limit' | 'delivery_url_validation_failed' — Indicates why the webhook has been disabled. `retry_limit`: webhook reached its retry limit. `usage_limit`: account is over its usage limit. `delivery_url_validation_failed`: delivery URL failed validation during webhook creation or update.
    - `delivery_url` string, uri, required — The delivery url of the webhook endpoint. The endpoint must respond within 60 seconds or the delivery is recorded as failed.
    - `execute_base_url` string, uri, required — The Unify Base URL events from connectors will be sent to after service id is appended.
    - `events` WebhookEventType[], required — The list of subscribed events for this webhook. [`*`] indicates that all events are enabled.
    - `updated_at` string, date-time, nullable — The date and time when the object was last updated.
    - `created_at` string, date-time, nullable — The date and time when the object was created.
  - `meta` Meta — Response metadata
    - `items_on_page` integer — Number of items returned in the data property of the response
    - `cursors` object — Cursors to navigate to previous or next pages through the API
      - `previous` string, nullable — Cursor to navigate to the previous page of results through the API
      - `current` string, nullable — Cursor to navigate to the current page of results through the API
      - `next` string, nullable — Cursor to navigate to the next page of results through the API
    - `total_count` integer — Number of records available in total for this resource
    - `warnings` object[], nullable — Non-fatal warnings emitted when optional workflow steps failed. Present only when at least one step degraded; the response status remains 200.
      - `type` string — Discriminator for the warning kind.
      - `status_code` integer, nullable — HTTP status code returned by the failed downstream request, when available.
      - `error` string, nullable — Short error description from the downstream provider, when available.
      - `operation` string, nullable — Identifier of the workflow step that failed.
      - `message` string, nullable — Detailed message from the downstream provider, when available.
  - `_raw` Raw, nullable — Raw response from the integration when raw=true query param is provided

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `402` — Payment Required
- `404` — The specified resource was not found
- `422` — Unprocessable
- `default` — Unexpected error

## Changes

- **2026-08-06** `08d192234a86` — 1 warning
  - added the new `vault.connection.migrated` enum value to the `data/events/items/` response property for the response status `200`
- **2026-07-14** `9bad0df9b686` — 3 warning
  - added the new `hris.time-off-request.created` enum value to the `data/events/items/` response property for the response status `200`
  - added the new `hris.time-off-request.deleted` enum value to the `data/events/items/` response property for the response status `200`
  - added the new `hris.time-off-request.updated` enum value to the `data/events/items/` response property for the response status `200`
- **2026-07-03** `710158d29d0b` — 3 warning
  - added the new `accounting.tracking_category.created` enum value to the `data/events/items/` response property for the response status `200`
  - added the new `accounting.tracking_category.deleted` enum value to the `data/events/items/` response property for the response status `200`
  - added the new `accounting.tracking_category.updated` enum value to the `data/events/items/` response property for the response status `200`
- **2026-06-19** `bfa53d213c59` — 1 info
  - added the optional property `meta` to the response with the `200` status
- …earlier changes not shown

[Full history](https://skmtc.dev/apideck-libraries/apis/webhook-api/changes/webhook/webhooks/:id/get.md)

---

[API](https://skmtc.dev/apideck-libraries/apis/webhook-api.md) · [All operations](https://skmtc.dev/apideck-libraries/apis/webhook-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/apideck-libraries/webhook-api/revisions/b81ea7031f4e/schema)