Clients commands

The clients command lets you create, view, and update clients in your NeetoInvoice workspace.

Identifier note: For show and update, use the client's short identifier (for example 59dad05d64c302e59a02) or UUID. UUIDs returned by create in client_id may return 404 on show; use the identifier from a successful projects show or clients show response instead.

Create a client

This command creates a new client. Use this when you need to onboard a billing client from the terminal.

neetoinvoice clients create --name "Acme Corp" --status active

Required flags:

• --name - Client name

Optional flags:

• --secondary-name - Secondary name

• --internal-notes - Internal notes

• --status - Status (active or archived)

• --due-in-days - Default invoice due in days

• --address - Full address

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

• --json - Return JSON envelope output

• --quiet - Return raw payload only

• --toon - Return TOON output

Sample output:

  NOTICE CODE  thumbs_up
  CLIENT ID    bb86c1b9-d034-4546-99ef-b7c9d1ca0360

  Show: neetoinvoice clients show <client-id>

Show a client

This command shows a client and its recipients. Use this when you need client details and recipient list without opening the Clients page.

neetoinvoice clients show 59dad05d64c302e59a02

Required argument:

• <client-id> - Client identifier. Refer to Getting the Client ID section for detailed instructions.

Optional flags:

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

• --json - Return JSON envelope output

• --quiet - Return raw payload only

• --toon - Return TOON output

Sample output:

  CLIENT
    NAME                                Acme Corp
    CREATED AT                          2026-06-23T05:01:32.561Z
    UPDATED AT                          2026-06-23T05:12:33.285Z
    IDENTIFIER                          eb29be2e8c203a71ec1d
    INTERNAL NOTES                      Updated via CLI
    CURRENCY                            USD
    STATUS                              active
    LOGO                                -
    ID                                  bb86c1b9-d034-4546-99ef-b7c9d1ca0360
    ORGANIZATION ID                     9b592c5a-ea32-408e-b7f8-3e80167b07ba
    DEFAULT INVOICE DUE IN DAYS         -
    INCLUDE HOURS BY PERSON IN INVOICE  No
    SECONDARY NAME                      -
    LAST INVOICE INTERVAL               all
  RECIPIENTS  []

  Update: neetoinvoice clients update <client-id> --name <name>
  Add recipient: neetoinvoice recipients create --client <client-id> --name <name> --email <email> --user-email <email>

Update a client

This command updates an existing client. Use this when you need to change client metadata from a script.

neetoinvoice clients update 59dad05d64c302e59a02 --internal-notes "Updated via CLI"

Required argument:

• <client-id> - Client identifier. Refer to Getting the Client ID section for detailed instructions.

Optional flags:

• --name - Client display name

• --secondary-name - Secondary name

• --internal-notes - Internal notes

• --status - Status (active or archived)

• --due-in-days - Default invoice due in days

• --address - Full address

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

• --json - Return JSON envelope output

• --quiet - Return raw payload only

• --toon - Return TOON output

Sample output:

NOTICE CODE  thumbs_up