---
title: "Creates an Invoice"
method: POST
path: "/invoices"
tags: ["Invoice"]
---

# Creates an Invoice

`POST /invoices`

Required permission: Invoices - Create

`subtotal`, `total`, `tax`, `balance_due`, `is_paid`, `verified_paid`, `tech_marked_paid`,
`pdf_url`, `customer_business_then_name` and `hardwarecost` are computed from the line
items and payments. They are returned on every response but ignored in a request; this
endpoint has never accepted them.

## Request body

- object
  - `customer_id` integer, required
  - `name` string
  - `number` string, required — Defaults to your account's next invoice number.
  - `date` string, date-time, required
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `due_date` string, date
  - `date_received` string, date
  - `employee` string — Defaults to the email address of the API token's owner.
  - `ticket_id` integer
  - `location_id` integer
  - `po_number` string
  - `note` string
  - `took_payment` boolean
  - `paid` boolean — Take payment for the invoice as soon as it is created. Only applies when `line_items` are sent in the same call.
  - `line_items` object[]
    - `item` string
    - `name` string
    - `product_id` integer — When given, `item`, `name`, `cost`, `price` and `taxable` default from the product.
    - `quantity` number
    - `cost` number
    - `price` number
    - `discount_percent` integer
    - `line_discount_percent` number
    - `discount_dollars` number
    - `taxable` boolean
    - `upc_code` string
    - `tax_note` string
    - `wholesale` number
    - `invoice_bundle_id` integer
    - `tax_rate_id` integer
    - `user_id` integer
    - `estimated_quantity` number
    - `old_price` number
    - `category_id` integer[]
    - `position` integer

## Response `200`

Invoice created

## Other responses

- `422` — Invalid request

## Changes

- **2026-09-02** `e3aca54060e1` — 12 warning, 9 info
  - removed the request property `balance_due`
  - removed the request property `contact_id`
  - removed the request property `customer_business_then_name`
  - removed the request property `hardwarecost`
  - …17 more

[Change history](https://skmtc.dev/syncromsp/apis/syncro/changes/invoices/post.md)

---

[API](https://skmtc.dev/syncromsp/apis/syncro.md) · [All operations](https://skmtc.dev/syncromsp/apis/syncro/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/syncromsp/syncro/revisions/e3aca54060e1/schema)