---
title: "Create Invoice"
method: POST
path: "/invoices"
tags: ["Invoices"]
---

# Create Invoice

`POST /invoices`

## Headers

- `x-business-id` string, required

## Request body

- Invoice
  - `createdByUserId` string
  - `dateIssued` string, date, required — YYYY/MM/DD
  - `invoiceNumber` integer, required
  - `clientDetails` ClientDetails, required
    - `contactId` string
    - `billingName` string, required
    - `contactName` string
    - `phone` string
    - `email` string, required — The email address(es) to send the invoice to. Max 5
    - `address` union
      - string
      - Address
        - `addressLine1` string, required
        - `addressLine2` string
        - `city` string, required
        - `zipCode` string, required
        - `state` string
        - `country` string, required
  - `paymentTerms` PaymentTerms[]
    - `name` string, required
    - `description` string
    - `days` integer, required
    - `paymentDueDate` string, date — YYYY/MM/DD
    - `discount` number
    - `penalty` number
  - `paymentInstructions` object
  - `billingPeriodStart` string, date
  - `billingPeriodEnd` string, date
  - `lineItems` LineItem[], required
    - `name` string, required
    - `description` string
    - `price` number, required
    - `taxRate` number
    - `taxable` boolean
    - `metadata` object
    - `inventoryId` string
    - `quantity` number
    - `total` number, required
    - `serviceDate` string, date — YYYY/MM/DD
    - `tags` unknown[]
      - unknown
  - `taxRate` number, required
  - `totalTax` number, required
  - `subTotal` number, required
  - `totalDue` number, required
  - `paymentDueDate` string, date, required — YYYY/MM/DD
  - `totalDiscount` number
  - `depositAmount` number
  - `depositDate` string, date — YYYY/MM/DD
  - `parentProjectId` string
  - `recurringFrequency` 'Weekly' | 'Bi-Weekly' | 'Monthly' | 'Bi-Monthly' | 'Quarterly' — An enumeration.
  - `status` 'draft' | 'issued' | 'paid' | 'partially paid' | 'overdue' | 'expired' | 'cancelled' | 'archived' | 'uncollectible' — An enumeration.
  - `metadata` object

## Response `200`

Successful Response

- InvoiceID
  - `invoiceId` string, required — Unique ID for this Invoice

## Other responses

- `404` — Not found
- `422` — Validation Error

---

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