---
title: "Retrieve a Webhook"
method: GET
path: "/public/v3/Webhooks/{webhookId}"
tags: ["Webhooks"]
---

# Retrieve a Webhook

`GET /public/v3/Webhooks/{webhookId}`

View information about a specific webhook within your organization.

## Path parameters

- `webhookId` integer, required

## Headers

- `x-tive-account-id` integer, required

## Response `200`

The requested webhook

- WebhookResponse
  - `webhookId` integer
  - `name` string, nullable
  - `description` string, nullable
  - `secretKey` string, nullable
  - `url` string, nullable
  - `httpMethod` string, nullable
  - `contentType` string, nullable
  - `headers` WebhookHeaderResponse[], nullable
    - `key` string, nullable
    - `value` string, nullable
  - `version` string, nullable
  - `template` string, nullable
  - `accountIds` integer[], nullable
  - `enabled` boolean
  - `applyToAllTrackers` boolean
  - `applyToAllShipments` boolean
  - `applyToAllAlertPresets` boolean
  - `authentication` WebhookAuthResponse
    - `authType` 1 | 2 | 3
    - `clientId` string, nullable
    - `oAuthTokenEndpointUrl` string, nullable
    - `oAuthScope` string, nullable
    - `oAuthAudience` string, nullable
    - `resourceOwnerUsername` string, nullable
    - `customBodyParams` string, nullable
    - `customAuthHeaders` string, nullable
    - `oAuthGrantType` string, nullable
    - `clientCredentialsInHeader` boolean

## Other responses

- `400` — The requested webhook is not available
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.net/tive/apis/tive-public-api.md) · [All operations](https://skmtc.net/tive/apis/tive-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tive/tive-public-api/revisions/9a8d869e3cdc/schema)
