---
title: "Create a webhook subscription (secret shown once)"
method: POST
path: "/v1/webhooks"
tags: ["webhooks"]
---

# Create a webhook subscription (secret shown once)

`POST /v1/webhooks`

## Request

- Base URL: `https://api.filingpulse.io`
- URL: `https://api.filingpulse.io/v1/webhooks`
- Auth: API key in header `X-API-Key`

## Request body

- WebhookCreate
  - `url` string, required
  - `events` string[]
  - `filters` object

## Response `201`

Successful Response

- unknown

## Other responses

- `401`: Missing or invalid X-API-Key.
- `403`: Active-webhook limit for your tier reached.
- `422`: Validation Error
- `429`: Per-minute rate limit or monthly quota exceeded. Per-minute 429s carry Retry-After; quota 429s carry X-Quota-Limit / X-Quota-Used. Quotas reset at 00:00 UTC on the 1st.

---

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