LexOffice

LexOffice API Operations

Actions10

Contacts Endpoint Actions
Invoices Endpoint Actions
- Render an Invoice Document (PDF)
- Retrieve an Invoice
Files Endpoint Actions
- Download a File

Overview

The Create Company - Vendor operation in the "Contacts Endpoint" resource of this n8n node allows you to create a new company contact in LexOffice with the role of a vendor. This is useful for businesses that need to manage their suppliers or vendors within LexOffice, automating the process of adding new vendor companies and their associated details (such as contact persons and billing addresses).

Common scenarios:

Automating onboarding of new vendors from another system into LexOffice.
Integrating supplier registration forms with LexOffice.
Keeping vendor records up-to-date by syncing data from other business tools.

Practical example:
When a new supplier signs up via your website, you can use this node to automatically create a corresponding vendor record in LexOffice, including their company name, main contact person, and billing address.

Properties

Name	Type	Meaning
Company Name	String	The name of the company to be created as a vendor.
Contact Persons	Fixed Collection	List of contact persons for the company. Each includes salutation, first/last name, email, and phone number.
Billing Addresses	Fixed Collection	Billing address details for the company, including street, zip, city, and country code (ISO 3166 alpha2).
Additional Fields	Collection	Optional fields: mobile phone number, private phone number, and business email for the company.

Output

The node returns a json object representing the newly created company vendor in LexOffice. The structure typically includes:

{
  "id": "string", // Unique identifier for the created contact
  "version": 0,
  "roles": {
    "vendor": {}
  },
  "company": {
    "name": "string",
    "contactPersons": [
      {
        "salutation": "string",
        "firstName": "string",
        "lastName": "string",
        "emailAddress": "string",
        "phoneNumber": "string"
      }
    ]
  },
  "addresses": {
    "billing": [
      {
        "street": "string",
        "zip": "string",
        "city": "string",
        "countryCode": "string"
      }
    ]
  },
  "emailAddresses": {
    "business": ["string"]
  },
  "phoneNumbers": {
    "mobile": ["string"],
    "private": ["string"]
  }
}

Note: Actual output may include additional metadata or fields depending on LexOffice API responses.

Dependencies

External Service: Requires access to the LexOffice API.
API Key: You must configure valid LexOffice API credentials (lexOfficeApi) in n8n.
n8n Configuration: No special environment variables beyond standard credential setup.

Troubleshooting

Common issues:

Missing Required Fields: If "Company Name" or required contact person fields are missing, the API will reject the request.
Invalid Country Code: The billing address requires a valid ISO 3166 alpha2 country code (e.g., "DE" for Germany).
Authentication Errors: Invalid or missing LexOffice API credentials will result in authentication failures.

Error messages and resolutions:

"400 Bad Request": Check that all required fields are filled and formatted correctly.
"401 Unauthorized": Ensure your LexOffice API credentials are set up and active in n8n.
"422 Unprocessable Entity": Review field values for correct formats (e.g., email addresses, country codes).