---
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

---

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