Create progress invoice
Create an invoice for a percent or a fixed amount of a job total. Needs Progressive invoicing on the account.
POST https://cotlet.dev/api/v1/housecall-pro/jobs/{job_id}/progress-invoices
write Confirm
Creates one invoice on a job for a percent or a fixed amount of its total, with its own due date. It needs Progressive invoicing switched on in Settings and a job created after that, and the total invoiced cannot pass 100 percent. The amount and due date cannot be edited afterwards; void and re-invoice instead. The invoice is not sent. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| job_id string required | string | Job ID from list_jobs. |
| percent number | number | Share of the job total, 1 to 100. Give percent or amount. |
| amount number | number | Fixed amount instead of a percent. |
| due_in_days integer | integer | Days from today until the invoice is due. |
Request
curl -X POST https://cotlet.dev/api/v1/housecall-pro/jobs/job_91d3a7/progress-invoices \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"percent":30,"due_in_days":14}'result = client.call("housecall-pro", "create_progress_invoice", {"job_id":"job_91d3a7","percent":30,"due_in_days":14})const result = await cotlet.call('housecall-pro', 'create_progress_invoice', {"job_id":"job_91d3a7","percent":30,"due_in_days":14});cotlet call housecall-pro create_progress_invoice --data '{"job_id":"job_91d3a7","percent":30,"due_in_days":14}'Example response
{
"invoice_id": "inv_4b2e8d",
"job_id": "job_91d3a7",
"status": "open",
"amount": 2520,
"percent": 30,
"due_date": "2026-10-28",
"invoiced_total": 2520,
"left_to_bill": 5880
}