---
title: "Billing webhook"
method: POST
path: "/v1/billing/webhook"
tags: ["Auth, Billing, and Provider Callbacks"]
---

# Billing webhook

`POST /v1/billing/webhook`

## Request

- Base URL: `https://getsocialclaw.com`
- URL: `https://getsocialclaw.com/v1/billing/webhook`
- Auth: API key in header `x-signature`

Processes Lemon Squeezy billing events.

Note: Requests must include the expected billing signature header.

## Request body

- OkResponse: Generic successful response.
  - `ok` unknown, required

## Response `200`

Successful response.

- WebhookResponse: Webhook acknowledgement.
  - `ok` unknown, required

## Other responses

- `400`: Invalid request.
- `401`: Missing, invalid, or unauthorized credentials.
- `404`: Requested resource was not found.
- `422`: Request body or semantic validation failed.

---

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