mercury_update_invoice
Update an existing invoice. Pass only the fields you want to change.
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 |
|---|---|---|---|
| dueDate | No | Due date (YYYY-MM-DD) | |
| ccEmails | No | ||
| poNumber | No | ||
| invoiceId | Yes | Invoice ID | |
| lineItems | No | ||
| payerMemo | No | ||
| invoiceDate | No | Invoice date (YYYY-MM-DD) | |
| internalNote | No | ||
| invoiceNumber | No |