---
title: "Square billing events, forwarded by the shared hub"
method: POST
path: "/api/billing/webhook"
---

# Square billing events, forwarded by the shared hub

`POST /api/billing/webhook`

## Request

- Base URL: `https://agentmandate-api.com`
- URL: `https://agentmandate-api.com/api/billing/webhook`
- Auth: API key in header `x-hub-signature`

Machine-to-machine only. The shared Square billing hub POSTs signed events here; the signature is verified over the exact request bytes. Not callable by API consumers — documented so the integration is auditable.

## Response `200`

Success

- object

## Other responses

- `400`: Deterministic error. Branch on `code`; quote `requestId` when reporting a problem.
- `401`: Deterministic error. Branch on `code`; quote `requestId` when reporting a problem.
- `500`: Deterministic error. Branch on `code`; quote `requestId` when reporting a problem.

---

[API](https://skmtc.dev/agentmandate-api/apis/agent-mandate.md) · [All operations](https://skmtc.dev/agentmandate-api/apis/agent-mandate/llms.txt) · [OpenAPI document](https://skmtc.dev/agentmandate-api/apis/agent-mandate/revisions/463fe122c4d8?raw)