Invoices commands

The invoices command lets you generate invoices for a client from the terminal.

Create an invoice

This command generates an invoice for a client from time entries and/or service line items. Use this when you want to bill unbilled work without opening the Invoices page.

neetoinvoice invoices create \
  --client 59dad05d64c302e59a02 \
  --user-email [email protected] \
  --data invoice-payload.json

Scalar fields are available as flags. For line items (invoice_time_entries, invoice_services, taxes, and email details) pass a JSON file via --data; flag values override the file's top-level keys.

Example invoice-payload.json with a time entry:

{
  "number": "INV-001",
  "invoice_time_entries": [
    {
      "time_entry_id": "42ba78eb-6a16-416f-aa87-bf12d5b192bc",
      "hours": 1.5,
      "hourly_rate": 100,
      "recorded_on": "06/22/2026",
      "notes": "CLI doc test",
      "project_id": "cb97c012-9beb-41f8-ab93-f25f9f1db849",
      "task_id": "03d76f53-1c06-4818-bb98-6487713cfa4c",
      "user_id": "4cf66641-7005-4dea-92b2-c29f537d1c31"
    }
  ]
}

Required flags:

• --client - Client identifier

• --user-email - Email of the acting organization user

Optional flags:

• --data - Path to JSON file with invoice payload

• --number - Invoice number

• --issue-date, --due-date - Dates (MM/DD/YYYY)

• --notes - Invoice notes

• --project-id - Project record UUID(s) to invoice (repeatable)

• --send-email - Email the invoice to client recipients

• --subdomain <name> - Target a specific logged-in workspace

• --json - Return JSON envelope output

• --quiet - Return raw payload only

• --toon - Return TOON output

Sample output:

{
  "data": {
    "notice_code": "thumbs_up",
    "invoice": {
      "number": "CLI-DOC-004",
      "status": "generating",
      "identifier": "a5d4a61d319f2292b272",
      "id": "dde21e3a-25cb-4b1e-a35d-31da2a8b5696",
      "issue_date": "2026-06-22",
      "total": "0.0"
    }
  }
}