Create VAT rate

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:

Provide the VAT percentage (0-100, e.g., 21 for 21%)
Set the effective date (dateFrom) when this rate should start applying
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.

POST/administration/vat-rates

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:write

AuthorizationBearer token (JWT) · headerrequired

Request body

requiredapplication/json

dateFromstring<date>required

The effective start date for this VAT rate. This date determines when the rate becomes active. The system automatically applies this rate to all invoices and quotes created on or after this date. You can set a future date to plan ahead for tax law changes. The date must be provided in ISO 8601 format (YYYY-MM-DD). The system validates that this date does not overlap with existing VAT rate periods.

isDefaultboolean

Whether this VAT rate is the default rate for the workspace. Default rates cannot be deleted and serve as a fallback. If not specified, defaults to false. Only one rate should typically be marked as default, though the system does not enforce this.

default: false

vatnumberrequired

The VAT (Value Added Tax) rate percentage that will be applied to invoices and quotes. This is a number between 0 and 100, where 21 represents 21% tax. The system uses this rate for all documents created on or after the effective date (dateFrom).

min 0 · max 100

Responses

200

successbooleanrequired

Operation success flag

401Unauthorized - Invalid or missing authentication token

403Forbidden - Insufficient API scopes or permissions

Request

curl -X POST "https://leadtime.app/api/public/administration/vat-rates" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "dateFrom": "2024-01-01",
  "isDefault": false,
  "vat": 21
}'

const response = await fetch("https://leadtime.app/api/public/administration/vat-rates", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "dateFrom": "2024-01-01",
  "isDefault": false,
  "vat": 21
})
});

import requests

response = requests.post(
    "https://leadtime.app/api/public/administration/vat-rates",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN",
        "Content-Type": "application/json"
    },
    json={
  "dateFrom": "2024-01-01",
  "isDefault": False,
  "vat": 21
},
)

Response

{
  "success": true
}