---
search:
  tags:
    - administration
    - POST
seo:
  description: >-
    Creates a new VAT rate for the workspace. This allows you to… Reference for
    the POST /administration/vat-rates endpoint in the Leadtime Public API API.
sidebar:
  badge: POST
  label: Create VAT rate
title: Create VAT rate
type: openapi-operation
---
Creates a new VAT rate for the workspace. This allows you to configure tax rates that will be automatically applied to invoices and quotes based on their creation date.

**Use cases:**
- Set up a new VAT rate that becomes effective on a specific date
- Plan future VAT changes in advance (e.g., when tax laws change)
- Configure historical VAT rates for accurate invoicing

**How to create a VAT rate:**
1. Provide the VAT percentage (0-100, e.g., 21 for 21%)
2. Set the effective date (dateFrom) when this rate should start applying
3. Optionally mark it as the default rate

**Validation rules:**
- VAT percentage must be between 0 and 100
- dateFrom must be a valid date
- The system validates that dateFrom does not overlap with existing VAT rates
- If validation fails, you will receive an error message explaining the issue

**Important notes:**
- Once the effective date arrives, the new rate automatically applies to all invoices and quotes created from that point forward
- Documents already issued keep their original tax rate
- The system finds the correct VAT rate by selecting the one with the most recent dateFrom that is less than or equal to the invoice/quote creation date

**Note:** This endpoint requires the WsSettings.manageSettings permission.

<Operation source="api-reference" id="vatratescontroller-createvatrate" />