---
title: "Get a webhook"
method: GET
path: "/v2/webhooks/{webHookKey}"
tags: ["Webhooks"]
---

# Get a webhook

`GET /v2/webhooks/{webHookKey}`

## Request

- Base URL: `https://api.streak.com/api`
- URL: `https://api.streak.com/api/v2/webhooks/{webHookKey}`
- Auth: HTTP bearer

Returns a subscription created by the authenticated user, subject to its team or pipeline permissions.

## Path parameters

- `webHookKey` string, required

## Response `200`

OK

- WebHook: A subscription that delivers pipeline or team events to a URL.
  - `key` string, required: Key identifying the webhook subscription.
  - `event` 'BOX_CREATE' | 'BOX_PRESENCE_CHANGED' | 'STAGE_CREATE' | 'BOX_NEW_EMAIL_ADDRESS' | 'BOX_EDIT' | 'BOX_CHANGE_STAGE' | 'BOX_CHANGE_PIPELINE' | 'BOX_DELETE' | 'COMMENT_CREATE' | 'TASK_CREATE' | 'TASK_COMPLETE' | 'TASK_DUE' | 'TASK_UPDATED' | 'BOX_NEW_EMAIL_RECEIVED' | 'CONTACT_CREATE' | 'ORG_CREATE' | 'CONTACT_UPDATE' | 'ORG_UPDATE' | 'CONTACT_DELETE' | 'ORG_DELETE' | 'MEETING_CREATE' | 'MEETING_UPDATE' | 'THREAD_ADDED_TO_BOX' | 'THREAD_REMOVED_FROM_BOX', required
  - `targetUrl` string, required: URL that receives webhook deliveries.
  - `pipelineKey` string, nullable: Pipeline being watched; omitted for team subscriptions.
  - `teamKey` string, nullable: Team being watched; omitted for pipeline subscriptions.
  - `userKey` string, required: User who created the subscription.
  - `token` string, nullable: Optional token sent in the webhook delivery header.
  - `creationDate` integer, nullable: When the subscription was created, in epoch milliseconds.
  - `lastSavedTimestamp` integer, required: When the subscription was last saved, in epoch milliseconds.

## Changes

- **2026-10-30** `3648671fd1cf`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/streakyc/apis/streak/changes/v2/webhooks/:webHookKey/get.md)

---

[API](https://skmtc.dev/streakyc/apis/streak.md) - [All operations](https://skmtc.dev/streakyc/apis/streak/llms.txt) - [OpenAPI document](https://skmtc.dev/streakyc/apis/streak/revisions/3648671fd1cf?raw)