---
title: "Stripe Billing webhook endpoint"
method: POST
path: "/v1/subscription/webhook"
tags: ["Subscription"]
---

# Stripe Billing webhook endpoint

`POST /v1/subscription/webhook`

## Request

- Base URL: `https://api.astrocal.dev`
- URL: `https://api.astrocal.dev/v1/subscription/webhook`
- Auth: none required

Receives Stripe Billing webhook events for subscription management. Verifies the signature using a separate billing webhook signing secret.

## Response `200`

Webhook received

- object
  - `received` boolean, required

## Other responses

- `400`: Invalid signature
- `500`: Handler failed (Stripe will retry)

---

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