---
title: "Create user invoice"
method: POST
path: "/workspaces/{workspace_id}/invoices"
tags: ["user-invoices"]
---

# Create user invoice

`POST /workspaces/{workspace_id}/invoices`

## Request

- Base URL: `https://localhost:8080/api/v9`
- URL: `https://localhost:8080/api/v9/workspaces/{workspace_id}/invoices`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/toggl/apis/toggl-api/docs/workspaces/:workspace_id/invoices/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates new user invoice.

## Path parameters

- `workspace_id` integer, required

## Request body

- ModelsUserInvoice
  - `billing_address` string
  - `created_at` string
  - `currency` string
  - `date` string
  - `deleted_at` string
  - `document_id` string
  - `due_date` string
  - `items` ModelsUserInvoiceItem[]
    - `amount` number
    - `description` string
    - `item_id` integer
    - `quantity` number
  - `message` string
  - `payment_terms` string
  - `purchase_number` string
  - `taxes` ModelsUserInvoiceTax[]
    - `amount` number
    - `name` string
    - `tax_id` integer
  - `updated_at` string
  - `user_id` integer
  - `user_invoice_id` integer
  - `workspace_address` string
  - `workspace_id` integer
  - `workspace_logo` string

## Response `200`

Successful operation.

- ModelsUserInvoice[]
  - `billing_address` string
  - `created_at` string
  - `currency` string
  - `date` string
  - `deleted_at` string
  - `document_id` string
  - `due_date` string
  - `items` ModelsUserInvoiceItem[]
    - `amount` number
    - `description` string
    - `item_id` integer
    - `quantity` number
  - `message` string
  - `payment_terms` string
  - `purchase_number` string
  - `taxes` ModelsUserInvoiceTax[]
    - `amount` number
    - `name` string
    - `tax_id` integer
  - `updated_at` string
  - `user_id` integer
  - `user_invoice_id` integer
  - `workspace_address` string
  - `workspace_id` integer
  - `workspace_logo` string

## Other responses

- `400`: Possible errors:<ul><li>Invalid JSON input</li></ul>
- `500`: Internal Server Error

---

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