---
title: "Polar webhook receiver (signature-verified, idempotent)"
method: POST
path: "/v1/billing/webhook"
tags: ["Account"]
---

# Polar webhook receiver (signature-verified, idempotent)

`POST /v1/billing/webhook`

## Request

- Base URL: `https://api.stackdata.io`
- URL: `https://api.stackdata.io/v1/billing/webhook`
- Auth: one of:
  - none
  - API key in header `X-API-Key`

Not for clients. Standard-Webhooks signature over the raw body; unknown event types are acknowledged with `handled` false.

## Response `200`

Handled or acknowledged.

- object
  - `ok` boolean
  - `handled` boolean

## Other responses

- `400`: Bad JSON.
- `401`: Bad signature.

---

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