---
title: "List webhook endpoints"
method: GET
path: "/v2/webhook-endpoints"
tags: ["Webhook Endpoints"]
---

# List webhook endpoints

`GET /v2/webhook-endpoints`

## Request

- Base URL: `https://api.prod.goaugment.com`
- URL: `https://api.prod.goaugment.com/v2/webhook-endpoints`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/goaugment/apis/augment-api/docs/v2/webhook-endpoints/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists public webhook endpoints for the authenticated brokerage. Customers do not pass `brokerageKey`; the brokerage is resolved from the API key.

Access to webhook management is gated by brokerage. Talk to Augment to enable access before relying on this endpoint.

## Response `200`

Webhook endpoints returned successfully

- WebhookEndpoint[]
  - `id` string, required: Webhook endpoint ID
  - `name` string: Display name for the endpoint
  - `url` string, uri, required: HTTPS URL that receives Augment webhook deliveries
  - `authType` 'bearerToken' | 'customHeaders', required: Outbound delivery auth type. Tokens are never returned by read or list responses.
  - `customHeaders` WebhookCustomHeaders: Custom headers sent with webhook deliveries.

## Other responses

- `400`: Invalid request
- `401`: Unauthorized
- `403`: Forbidden

---

[API](https://skmtc.dev/goaugment/apis/augment-api.md) - [All operations](https://skmtc.dev/goaugment/apis/augment-api/llms.txt) - [OpenAPI document](https://skmtc.dev/goaugment/apis/augment-api/revisions/b61097634d79?raw)