---
title: "List Webhooks"
method: GET
path: "/v1/projects/{project}/webhooks"
tags: ["Webhooks"]
---

# List Webhooks

`GET /v1/projects/{project}/webhooks`

List Webhooks

## Path parameters

- `project` string, required

## Query parameters

- `page` number
- `perPage` number
- `sortBy` 'createdAt' | 'updatedAt' | 'name' | 'key' | 'propertyKey'
- `sortOrder` 'asc' | 'desc'
- `search` string
- `createdBy` string

## Response `200`

- Webhook[]
  - `name` string, required — The name of the Webhook
  - `description` string — The description of the Webhook
  - `_id` string, required — A unique Webhook ID
  - `_project` string, required — The Project owning the Webhook
  - `_feature` string — Events in this webhook will only be triggered for this feature
  - `_environments` string[], required — Events in this webhook will only be triggered for these environments
  - `url` string, required — The URL to call once the type is triggered
  - `events` string[], required — The events that trigger the webhook
  - `source` 'api' | 'dashboard' | 'importer' | 'github.code_usages' | 'github.pr_insights' | 'gitlab.code_usages' | 'gitlab.pr_insights' | 'bitbucket.code_usages' | 'bitbucket.pr_insights' | 'terraform' | 'cli' | 'slack' | 'mcp' — Source where webhook was created from
  - `createdBy` string — Auth0 User who created the webhook.
  - `createdAt` string, date-time, required — The date the webhook was created, set by the API
  - `updatedAt` string, date-time, required — The date the webhook was last updated, set by the API
  - `outputFormat` object — The type of format to send the payload changes in
  - `_slackIntegration` string — The Slack Integration ID if the Webhook is created from a Slack command

## Other responses

- `400`
- `401`
- `403`
- `404`

---

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