---
search:
  tags:
    - organizations
    - PATCH
seo:
  description: >-
    Partially updates invoice and billing settings for an… Reference for the
    PATCH /organizations/{id}/invoice-settings endpoint in the Leadtime Public
    API API.
sidebar:
  badge: PATCH
  label: Update organization invoice settings
title: Update organization invoice settings
type: openapi-operation
---
Partially updates invoice and billing settings for an organization. Only the fields you provide will be updated; all other fields remain unchanged.

**What are Invoice Settings?**
Invoice settings define organization-specific billing parameters that override workspace defaults, enabling customer-specific payment terms, reminder rules, and invoice texts.

**Available settings:**
- **Payment terms**:
  - hourRate: Customer-specific hourly rate (number or null)
  - invoiceDueDays: Days until payment is due, 1-120 (number or null)
  - invoiceLanguage: Language code for invoices (string or null)
- **Reminder fees**:
  - enableInvoiceReminderFee: Enable reminder fees (boolean or null)
  - invoiceReminderFee: Reminder fee amount, 0-1000 (number or null)
- **Interest on arrears**:
  - enableInvoiceInterest: Enable interest on overdue invoices (boolean or null)
  - baseInvoiceInterest: Base interest rate percentage, 0-1000 (number or null)
  - invoiceInterest: Interest rate percentage, 0-1000 (number or null)
- **Custom text templates**: Object with HTML or Markdown content (converted to IDoc internally):
  - withBestRegards, invoiceGreeting, invoiceFooter
  - invoiceReminderFeeWarning
  - firstReminderGreeting, firstReminderFooter
  - secondReminderGreeting, secondReminderFooter
  - cancelationBody

**Custom text templates:**
- Can be provided as HTML or Markdown
- Will be automatically converted to internal IDoc format
- Support macros/variables (e.g., #dear, #clientCompanyName, #invoiceNumber)
- Set to null or empty string to clear a template
- Omit fields you do not want to change

**Behavior:**
- Omitted fields remain unchanged
- Provided fields replace existing values
- Set fields to null to reset to workspace defaults (where applicable)
- Custom texts are converted from HTML/Markdown to IDoc format for storage

**What is returned:**
The complete updated invoice settings object, with custom texts returned as HTML.

**Note:** This endpoint requires the Organizations.edit permission. The organization must exist in your workspace and not be deleted. Custom texts are stored internally in IDoc format but can be provided as HTML or Markdown.

<Operation source="api-reference" id="organizationscontroller-patchorganizationinvoicesettings" />