---
title: "Create a subscription invoice"
method: POST
path: "/subscription/invoice"
---

# Create a subscription invoice

`POST /subscription/invoice`

Create a single invoice record for an existing subscription in the current project. The subscription must belong to the project identified by the API key.

## Request body

- object
  - `subscription_id` integer, required — ID of the subscription (must belong to the current project).
  - `invoice_id` string, nullable — External invoice/charge ID.
  - `status` 0 | 1 | 2 | 3 | 4, required — 0=Processing, 1=Paid, 2=Unpaid, 3=Refund, 4=Unknown
  - `is_refund` boolean
  - `date` string, required — Invoice date (e.g. timestamp string).
  - `amount` number, required
  - `amount_usd` number, nullable

## Response `201`

Invoice created successfully.

- object
  - `success` integer
  - `data` object — Created subscription invoice (id, subscription_id, invoice_id, status, date, amount, amount_usd, is_refund, etc.)

## Other responses

- `422` — Validation error (e.g. subscription not found or not in project).

---

[API](https://skmtc.net/web2wave/apis/web2wave-api.md) · [All operations](https://skmtc.net/web2wave/apis/web2wave-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/web2wave/web2wave-api/versions/c88545119271/schema)