---
title: "List your webhook endpoints (the signing secret is never returned)"
method: GET
path: "/api/webhooks"
---

# List your webhook endpoints (the signing secret is never returned)

`GET /api/webhooks`

## Request

- Base URL: `https://postwire.io`
- URL: `https://postwire.io/api/webhooks`
- Auth: HTTP bearer

PostWire calls your endpoints when a post goes out or fails on a network, when a connection must be signed in again, and (only for an endpoint that asks for them) when a post is held for approval and when someone decides. Every plan, with an endpoint limit per plan: Free 2, Starter 5, Pro 10, Agency 25, Scale 50 (max in the response is yours). Events and signature: https://postwire.io/docs/webhooks/ (payload schema: components.schemas.WebhookEvent).

## Response `200`

{ webhooks: [Webhook], events: [string] (every event an endpoint can ask for), default_events: [string] (what an endpoint created without events gets), max: integer (your plan's endpoint limit: Free 2, Starter 5, Pro 10, Agency 25, Scale 50) }

## Other responses

- `503`: code webhooks_unavailable: webhooks are not switched on on this server yet

---

[API](https://skmtc.dev/postwire/apis/postwire-api.md) · [All operations](https://skmtc.dev/postwire/apis/postwire-api/llms.txt) · [OpenAPI document](https://skmtc.dev/postwire/apis/postwire-api/revisions/513a409ab8f7?raw)