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      (14 fields)
  RECIPIENTS  []  

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