Teamleader

Overview

This node integrates with the Teamleader API to perform various operations on different resources. Specifically, for the Companies resource with the List operation, it retrieves a list of companies from the Teamleader system. This is useful in scenarios where you want to fetch company data for reporting, synchronization, or further automation workflows.

For example, you might use this node to:

• Retrieve a list of all companies to update a CRM system.
• Fetch companies to generate reports or dashboards.
• Use the company data as input for other workflow steps like sending emails or creating tasks.

Properties

The "Limit" property allows users to specify how many company records they want to retrieve in one execution, with a default of 50.

Output

The node outputs an array of JSON objects representing companies retrieved from the Teamleader API. Each object corresponds to a single company and contains its details as provided by the API.

• The output field json contains the company data.
• If multiple companies are returned, each company is an element in the output array.
• No binary data is output by this node.

Example output structure (simplified):

[
  {
    "id": "company-id-1",
    "name": "Company One",
    "vat_number": "123456789",
    "emails": [
      {
        "type": "primary",
        "email": "contact@companyone.com"
      }
    ],
    "addresses": [
      {
        "type": "invoicing",
        "line_1": "123 Main St",
        "city": "CityName",
        "country": "CountryName"
      }
    ],
    ...
  },
  {
    "id": "company-id-2",
    "name": "Company Two",
    ...
  }
]

Dependencies

• Requires an OAuth2 API credential configured for Teamleader with appropriate permissions.
• The node makes POST requests to the Teamleader API endpoint at https://api.focus.teamleader.eu.
• The API token must have access rights to read company data.

Troubleshooting

• No data returned but request was successful: This message indicates that the API call succeeded but no company data was returned. Check if there are companies in your Teamleader account or adjust filters if any are applied.
• No data got returned: This error means the response did not contain expected data. Verify API credentials and permissions.
• API authentication errors: Ensure the OAuth2 credentials are valid and refreshed.
• Rate limits or API errors: If the API returns errors due to rate limiting or invalid parameters, check the Teamleader API documentation and adjust usage accordingly.

Links and References

• Teamleader API Documentation
• n8n OAuth2 Credential Setup