Update company settings

Updates company master data. All fields are optional - only provided fields will be updated.

What is Company Data? Company data contains all the legal, administrative, and contact details of your company. This information is used automatically throughout the system in invoices, contracts, projects, and other documents.

What can be updated:

Company identification: Official company name and legal form (e.g., GmbH, AG, LLC, sole proprietorship)
Complete address: Country, postal code, city, street, house number
Contact information: Phone number, email address, website URL, fax number
Tax and registry details: Tax identification number (needed for invoices), business registration number, registration court
Company description: Short description of what the company does (e.g., “Manufacturer of Leadtime – an ERP system for software providers”)
Financial information: Bank account number (IBAN format) used for invoices

Validation rules:

Email addresses must be valid email format
Website URLs must be valid URL format
All string fields can be empty strings to clear values

Note: This endpoint requires the Company.manage permission. Changes take effect immediately and are used throughout the system for document generation and communication.

PATCH/administration/company-settings

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:write

AuthorizationBearer token (JWT) · headerrequired

Request body

requiredapplication/json

companyCitystring

City of the company address. Part of the complete address used on invoices, contracts, and other documents.

companyCountrystring

Country code (ISO 3166-1 alpha-2 format, e.g., "DE", "US") of the company address. Part of the complete address used on invoices, contracts, and other documents.

companyEmailstring

Main business contact email address. Used for contact information in documents and communications. Must be valid email format.

companyFaxstring

Company fax number (optional). Used for contact information in documents and communications. For companies that still use fax.

companyHouseNumberstring

House number of the company address. Part of the complete address used on invoices, contracts, and other documents.

companyLegalFormstring

Legal form or structure of the company (e.g., GmbH, AG, LLC, Inc., sole proprietorship). Used in legal documents and official communications.

companyNamestring

Official business name of the company. Used in documents, invoices, contracts, and projects throughout the system.

companyPhonestring

Official company phone number. Used for contact information in documents and communications.

companyRegistrationCourtstring

Responsible registration court where the company is registered. Example: "Amtsgericht Berlin" for German companies.

companyRegistrationNumberstring

Business registration number or commercial registry entry number. Format varies by country (e.g., "HRB 12345" for German companies).

companyShortDescriptionstring

Short description of what the company does. Optional field to describe the company's business activities. Example: "Manufacturer of Leadtime – an ERP system for software providers."

companyStreetstring

Street name of the company address. Part of the complete address used on invoices, contracts, and other documents.

companyTaxNumberstring

Tax identification number. Required for invoices and tax documents. Format varies by country (e.g., "DE123456789" for Germany).

companyWebsitestring

Company website URL (optional). Used for contact information in documents and communications. Must be valid URL format.

companyZipstring

ZIP or postal code of the company address. Part of the complete address used on invoices, contracts, and other documents.

invoiceAccountNumberstring

Bank account number in IBAN format used for invoices. This account number appears on invoices for payment purposes.

Responses

200

successbooleanrequired

Operation success flag

401

Unauthorized - Invalid or missing authentication token

403

Forbidden - Insufficient API scopes or permissions

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

OAuth2 access tokenRemember on this deviceInclude my values in samples

Bodyapplication/json

companyCitystringCity of the company address. Part of the complete address used on invoices, contracts, and other documents.companyCountrystringCountry code (ISO 3166-1 alpha-2 format, e.g., "DE", "US") of the company address. Part of the complete address used on invoices, contracts, and other documents.companyEmailstringMain business contact email address. Used for contact information in documents and communications. Must be valid email format.companyFaxstringCompany fax number (optional). Used for contact information in documents and communications. For companies that still use fax.companyHouseNumberstringHouse number of the company address. Part of the complete address used on invoices, contracts, and other documents.companyLegalFormstringLegal form or structure of the company (e.g., GmbH, AG, LLC, Inc., sole proprietorship). Used in legal documents and official communications.companyNamestringOfficial business name of the company. Used in documents, invoices, contracts, and projects throughout the system.companyPhonestringOfficial company phone number. Used for contact information in documents and communications.companyRegistrationCourtstringResponsible registration court where the company is registered. Example: "Amtsgericht Berlin" for German companies.companyRegistrationNumberstringBusiness registration number or commercial registry entry number. Format varies by country (e.g., "HRB 12345" for German companies).companyShortDescriptionstringShort description of what the company does. Optional field to describe the company's business activities. Example: "Manufacturer of Leadtime – an ERP system for software providers."companyStreetstringStreet name of the company address. Part of the complete address used on invoices, contracts, and other documents.companyTaxNumberstringTax identification number. Required for invoices and tax documents. Format varies by country (e.g., "DE123456789" for Germany).companyWebsitestringCompany website URL (optional). Used for contact information in documents and communications. Must be valid URL format.companyZipstringZIP or postal code of the company address. Part of the complete address used on invoices, contracts, and other documents.invoiceAccountNumberstringBank account number in IBAN format used for invoices. This account number appears on invoices for payment purposes.

Request

curl -X PATCH "https://leadtime.app/api/public/administration/company-settings" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "companyCity": "Berlin",
  "companyCountry": "DE",
  "companyEmail": "contact@acme.com",
  "companyFax": "+49 30 87654321",
  "companyHouseNumber": "42",
  "companyLegalForm": "GmbH",
  "companyName": "Acme Corporation",
  "companyPhone": "+49 30 12345678",
  "companyRegistrationCourt": "Amtsgericht Berlin",
  "companyRegistrationNumber": "HRB 12345",
  "companyShortDescription": "string",
  "companyStreet": "123 Main St",
  "companyTaxNumber": "DE123456789",
  "companyWebsite": "https://acme.com",
  "companyZip": "10115",
  "invoiceAccountNumber": "DE89370400440532013000"
}'

const response = await fetch("https://leadtime.app/api/public/administration/company-settings", {
  method: "PATCH",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"companyCity\": \"Berlin\",\n  \"companyCountry\": \"DE\",\n  \"companyEmail\": \"contact@acme.com\",\n  \"companyFax\": \"+49 30 87654321\",\n  \"companyHouseNumber\": \"42\",\n  \"companyLegalForm\": \"GmbH\",\n  \"companyName\": \"Acme Corporation\",\n  \"companyPhone\": \"+49 30 12345678\",\n  \"companyRegistrationCourt\": \"Amtsgericht Berlin\",\n  \"companyRegistrationNumber\": \"HRB 12345\",\n  \"companyShortDescription\": \"string\",\n  \"companyStreet\": \"123 Main St\",\n  \"companyTaxNumber\": \"DE123456789\",\n  \"companyWebsite\": \"https://acme.com\",\n  \"companyZip\": \"10115\",\n  \"invoiceAccountNumber\": \"DE89370400440532013000\"\n}"
});

import requests

response = requests.patch(
    "https://leadtime.app/api/public/administration/company-settings",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN",
        "Content-Type": "application/json"
    },
    data="{\n  \"companyCity\": \"Berlin\",\n  \"companyCountry\": \"DE\",\n  \"companyEmail\": \"contact@acme.com\",\n  \"companyFax\": \"+49 30 87654321\",\n  \"companyHouseNumber\": \"42\",\n  \"companyLegalForm\": \"GmbH\",\n  \"companyName\": \"Acme Corporation\",\n  \"companyPhone\": \"+49 30 12345678\",\n  \"companyRegistrationCourt\": \"Amtsgericht Berlin\",\n  \"companyRegistrationNumber\": \"HRB 12345\",\n  \"companyShortDescription\": \"string\",\n  \"companyStreet\": \"123 Main St\",\n  \"companyTaxNumber\": \"DE123456789\",\n  \"companyWebsite\": \"https://acme.com\",\n  \"companyZip\": \"10115\",\n  \"invoiceAccountNumber\": \"DE89370400440532013000\"\n}",
)

Response

{
  "success": true
}