Teamleader icon

Teamleader

Consume Teamleader API

Actions60

Overview

The Teamleader node integrates with the Teamleader API to perform various operations on different resources such as users, teams, deals, tickets, contacts, companies, and more. Specifically, for the Deals resource with the List operation, this node fetches a list of deals from the Teamleader platform.

This node is beneficial in scenarios where you want to automate workflows involving deal management, such as retrieving current deals for reporting, syncing deals with other systems, or triggering actions based on deal data.

Example use case:

  • Automatically retrieve the latest 50 deals from Teamleader to update a CRM dashboard.
  • Fetch deals periodically to analyze sales pipeline stages or forecast revenue.

Properties

Name Meaning
Limit The number of results to return. This controls how many deals are fetched in one request.

Output

The output is a JSON array containing deal objects returned by the Teamleader API. Each object represents a deal with its associated properties as provided by the API.

  • If multiple deals are returned, each deal is an element in the array.
  • If only one deal is returned, it is still wrapped in an array.
  • If no data is returned but the request was successful, the output contains an object with a message indicating no data was returned.
  • In case of errors (and if "continue on fail" is enabled), the output includes error messages per item.

The node does not output binary data.

Dependencies

  • Requires an OAuth2 API credential configured in n8n to authenticate requests to the Teamleader API.
  • The node makes POST requests to the Teamleader API endpoint at https://api.focus.teamleader.eu.
  • The API call uses the operation name as the URL path (e.g., deals.list).

Troubleshooting

  • No data returned but request was successful: This means the API responded without errors but did not return any deal data. Verify that there are deals available in your Teamleader account and that the query parameters (like limit) are set correctly.
  • No data got returned: This error indicates the response did not contain expected data. Check API credentials and permissions.
  • API errors: Errors thrown by the Teamleader API will be surfaced unless "continue on fail" is enabled, in which case they appear in the output as error messages.
  • Ensure the OAuth2 credentials are valid and have sufficient permissions to access deal data.
  • Network issues or incorrect API endpoint configuration can cause request failures.

Links and References

Discussion