# Create a customer invoice

> POST /api/customers/{id}/create-invoice on the Vigilbase One API.

Source: https://docs.vigilbase.com/one/api/reference/customers/post-customers-id-create-invoice

`POST https://one.vigilbase.com/api/customers/{id}/create-invoice`

> Needs a recent sign-in: renewing a token doesn't count, and MCP sessions and API keys are always refused. See [changes that need a recent sign-in](https://docs.vigilbase.com/one/api#changes-that-need-a-recent-sign-in).

## Authorizations

- `Authorization` (string, header, required): Bearer access token from Vigilbase Identity (`auth.vigilbase.com`), sent as `Authorization: Bearer <token>`. The CLI gets one with `vigilbase login`. Organisation API keys can't call this endpoint: it needs a recent sign-in by a person.
- Permissions checked: `write:billing`

## Path parameters

- `id` (string, required)

## Body (application/json)

- `operationId` (string, required)
- `lineItems` (object[], required): Min 1 items, max 250 items.
  - `name` (string, required): Min length 1, max length 250.
  - `description` (string): Max length 1000.
  - `unitAmount` (number, required)
  - `currency` (string): Default `"usd"`. Pattern ^[a-z]{3}$.
  - `quantity` (integer): Default `1`. Minimum 1, maximum 1000000.
  - `metadata` (object): Default `{}`.
- `dueDate` (string)
- `description` (string): Max length 1000.
- `metadata` (object): Default `{}`.
- `autoAdvance` (boolean): Default `true`.
- `collectionMethod` (string): One of `charge_automatically`, `send_invoice`. Default `"charge_automatically"`.
- `sendEmail` (boolean): Default `false`.
- `emailAddress` (string)

## Responses

### 200

Success

### 401

Authentication required

### 403

Not permitted

## Example request

```bash
# Token from `vigilbase login`. API keys can't call this.
curl --request POST \
  --url 'https://one.vigilbase.com/api/customers/{id}/create-invoice' \
  --header "Authorization: Bearer $VIGILBASE_TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{"operationId":"<uuid>","lineItems":[{"name":"<string>","description":"<string>","unitAmount":123,"currency":"usd","quantity":1,"metadata":{}}],"dueDate":"<string>","description":"<string>","metadata":{},"autoAdvance":true,"collectionMethod":"charge_automatically","sendEmail":false,"emailAddress":"<string>"}'
```