---
title: "Create a bulk invoice run"
method: POST
path: "/invoices/bulk"
tags: ["Billing"]
---

# Create a bulk invoice run

`POST /invoices/bulk`

## Request

- Base URL: `https://api.app.subskribe.com`
- URL: `https://api.app.subskribe.com/invoices/bulk`
- Auth: API key in header `X-API-Key`

Creates a bulk invoice run as specified by the input parameters. On success the id of the run is returned.

## Request body

- BulkInvoiceRunInput
  - `entityId` string
  - `name` string
  - `description` string
  - `targetDate` integer
  - `invoiceDate` integer
  - `chargeInclusionOption` 'INCLUDE_USAGE' | 'EXCLUDE_USAGE' | 'ONLY_USAGE'
  - `isHistorical` boolean

## Response `200`

successful operation

- string

---

[API](https://skmtc.dev/dealhub/apis/subskribe-api.md) - [All operations](https://skmtc.dev/dealhub/apis/subskribe-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dealhub/apis/subskribe-api/revisions/c1ee531b82ce?raw)