---
title: "Create CustomerInvoiceCharge"
method: POST
path: "/provider/customer_invoices/{customer_invoice_id}/charges"
tags: ["CustomerInvoiceCharge"]
---

# Create CustomerInvoiceCharge

`POST /provider/customer_invoices/{customer_invoice_id}/charges`

## Request

- Base URL: `https://api.sandbox.hint.com/api`
- URL: `https://api.sandbox.hint.com/api/provider/customer_invoices/{customer_invoice_id}/charges`
- Auth: API key in header `AUTHORIZATION`

The invoice must be in `draft` status. Adding a charge to an issued invoice fails with
`422 Invoice must be in draft status`; return the invoice to draft first.

## Path parameters

- `customer_invoice_id` string, required

## Request body

- ProviderCustomerInvoicesChargesControllerCreateBody
  - `quantity` number, double, required
  - `price_in_cents` number, double, required
  - `name` string, required
  - `description` string
  - `date` string, date
  - `patient` Association
    - `id` string, required
  - `practitioner` Association
    - `id` string, required
  - `category` Category
    - `id` string, required: Optional if type is specified
    - `type` 'memberships' | 'labs' | 'medications' | 'vitamins_and_supplements' | 'vaccines' | 'imaging' | 'supplies_and_dme' | 'retail_items' | 'office_visits' | 'procedures' | 'fees', required: Ignored if ID is specified
  - `charge_item` Association
    - `id` string, required
  - `location` Association
    - `id` string, required

## Response `201`

Successful response

## Changes

- **2026-11-03** `c9bda0d2dd87`: 1 breaking
  - added the new required request property `category/type`

[Operation history](https://skmtc.dev/hint/apis/partner-endpoints/changes/provider/customer_invoices/:customer_invoice_id/charges/post.md)

---

[API](https://skmtc.dev/hint/apis/partner-endpoints.md) - [All operations](https://skmtc.dev/hint/apis/partner-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/hint/apis/partner-endpoints/revisions/c9bda0d2dd87?raw)