---
title: "Creates a manual charge billing item for a customer."
method: POST
path: "/billing/manual-charge"
tags: ["Billing"]
---

# Creates a manual charge billing item for a customer.

`POST /billing/manual-charge`

## Request body

- CreateManualChargeEndpointInput
  - `name` string, required — The name of the manual charge.
  - `billingPeriodId` string, required — The billing period to add the charge to.
  - `organizationId` string, required — The organization the charge is billed to.
  - `customerId` string, uuid, nullable — The member the charge is recorded against, for auditability. Optional — omit it for a charge that belongs to the organization as a whole rather than to one of its members.
  - `customerMail` string, nullable — The email address of the member named by CustomerId.
  - `quantity` integer, nullable — The number of units billed. The charge total is Quantity × UnitPrice, and the invoice line shows the unit breakdown.
  - `unitPrice` number, double, nullable — The price per unit. Positive for fees, negative for refunds.
  - `reason` 'PlatformFee' | 'Refund' | 'Other' | 'MinimumSpendCommitment', required
  - `comment` string, nullable — An optional comment describing the charge.

## Response `200`

OK

- CreateManualChargeEndpointOutput
  - `id` string, required — The ID of the created billing item.

## Other responses

- `400` — Bad Request
- `401` — Unauthenticated
- `403` — Forbidden

---

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