mercury_update_invoice
Update an outstanding invoice by providing only the fields to change. Merges modifications—like line items, due date, memo, or PO number—with the current invoice before submission. Returns the updated invoice details.
Instructions
Update an existing invoice. Pass only the fields you want to change.
USE WHEN: amending an outstanding invoice (line items, due date, memo, PO number) before the customer pays. The MCP fetches the current invoice and merges your changes before submitting — Mercury's update endpoint requires the full payload despite the API docs implying PATCH.
DO NOT USE: to cancel an invoice (use mercury_cancel_invoice). To change the customer or the destination account, cancel + recreate. Once an invoice is paid, updates are likely rejected by Mercury — fetch first to confirm status.
SIDE EFFECTS: overwrites the invoice on Mercury's side. The customer-facing payment URL stays the same. If the invoice was already emailed, the customer is NOT re-notified of the change — communicate the change out-of-band if needed.
RETURNS: { id, status, amount, ... } — the updated invoice.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| invoiceId | Yes | Invoice ID | |
| invoiceDate | No | Invoice date (YYYY-MM-DD) | |
| dueDate | No | Due date (YYYY-MM-DD) | |
| lineItems | No | ||
| ccEmails | No | ||
| payerMemo | No | ||
| internalNote | No | ||
| poNumber | No | ||
| invoiceNumber | No |