Teamleader icon

Teamleader

Consume Teamleader API

Actions60

Overview

This node integrates with the Teamleader API to retrieve detailed information about various resources, including projects. Specifically, for the Projects resource with the Info operation, it fetches detailed data about a single project identified by its ID.

Common scenarios where this node is beneficial include:

  • Retrieving up-to-date project details for reporting or dashboard purposes.
  • Automating workflows that depend on project status or metadata.
  • Integrating project information into other systems or processes.

For example, you could use this node to get the current status and details of a specific project when a related event occurs, such as a task completion or a milestone reached.

Properties

Name Meaning
ID The unique identifier of the project to retrieve information about. This is a required string input.

Output

The node outputs JSON data representing the detailed information of the specified project. The structure corresponds to the Teamleader API's project info response, typically including fields such as project name, description, status, start and end dates, associated contacts or companies, and other metadata.

If the API returns multiple items (which is unlikely for an info operation), they are output as an array; otherwise, a single object is returned.

No binary data output is produced by this operation.

Dependencies

  • Requires an OAuth2 API credential configured in n8n to authenticate with the Teamleader API.
  • The node makes HTTP POST requests to the Teamleader API endpoint https://api.focus.teamleader.eu using the path corresponding to the operation (projects-v2/projects.info for project info).
  • Proper API permissions must be granted to the OAuth2 credential to access project information.

Troubleshooting

  • No data returned but request was successful: This message indicates the API call succeeded but returned no data. Verify that the provided project ID is correct and that the project exists.
  • No data got returned: An error thrown when the API response lacks expected data. Check network connectivity, API credentials, and ensure the project ID is valid.
  • Authentication errors: Ensure the OAuth2 credentials are correctly set up and have not expired.
  • Invalid ID format: The project ID must be a valid string matching the Teamleader system's project identifiers.

To resolve issues:

  • Double-check the project ID input.
  • Confirm API credentials and permissions.
  • Review Teamleader API status and limits.

Links and References

Discussion