---
title: "List webhooks"
method: GET
path: "/api/webhooks"
tags: ["Webhooks"]
---

# List webhooks

`GET /api/webhooks`

## Request

- Base URL: `https://api.postproxy.dev`
- URL: `https://api.postproxy.dev/api/webhooks`
- Auth: HTTP bearer

Retrieves all webhooks configured for your account.

## Query parameters

- `profile_group_id` string

## Response `200`

List of webhooks

- object
  - `data` WebhookSubscription[]
    - `id` string: Webhook id.
    - `url` string: HTTPS URL that receives webhook events.
    - `events` string[]: Subscribed event types (["*"] means all events).
    - `enabled` boolean: Whether the webhook is enabled.
    - `description` string: Description for the webhook.
    - `secret` string: Signing secret used to verify webhook signatures. Only included when fetching a single webhook or immediately after creation.
    - `created_at` string: ISO 8601 creation time.
    - `updated_at` string: ISO 8601 last update time.

## Other responses

- `401`: Invalid, missing, or insufficient API key permissions.

---

[API](https://skmtc.dev/postproxy/apis/postproxy-social-media-api.md) - [All operations](https://skmtc.dev/postproxy/apis/postproxy-social-media-api/llms.txt) - [OpenAPI document](https://skmtc.dev/postproxy/apis/postproxy-social-media-api/revisions/d54482ac4ce7?raw)