Teamleader icon

Teamleader

Consume Teamleader API

Actions60

Overview

The "Deals Info" operation in this Teamleader node retrieves detailed information about a single deal by its ID. This is useful when you want to fetch all available data for a specific deal within your CRM or sales pipeline managed in Teamleader.

Common scenarios include:

  • Displaying detailed deal information in dashboards or reports.
  • Using deal details to trigger further automation workflows.
  • Verifying or auditing deal data before performing updates or other operations.

For example, you might use this node to get the current status, responsible user, phase, and estimated closing date of a deal identified by its unique ID.

Properties

Name Meaning
ID The unique identifier of the deal to retrieve information for. This is required to specify which deal's details should be fetched.

Output

The node outputs a JSON object containing the full details of the specified deal as returned by the Teamleader API. The structure typically includes fields such as:

  • Deal title
  • Summary
  • Source ID
  • Department ID
  • Responsible user ID
  • Phase ID
  • Estimated probability
  • Estimated closing date
  • Other metadata related to the deal

If multiple deals were returned (not typical for an info operation), it would output an array of deal objects, but here it returns a single deal object.

No binary data output is involved in this operation.

Dependencies

  • Requires an OAuth2 API credential configured for Teamleader with appropriate permissions to access deal data.
  • The node makes HTTP POST requests to the Teamleader API endpoint https://api.focus.teamleader.eu using the /deals.info operation path.
  • Proper API authentication token must be set up in n8n credentials for successful requests.

Troubleshooting

  • Missing or invalid ID: If the ID property is empty or incorrect, the API will not return deal data. Ensure the ID corresponds to an existing deal.
  • API errors: Errors from the Teamleader API (e.g., unauthorized, not found) will be thrown as node errors. Check that the OAuth2 credentials are valid and have sufficient permissions.
  • No data returned: If the API response does not contain expected data, the node throws an error indicating no data was returned. Verify the deal ID and API availability.
  • Rate limits or connectivity issues: Network problems or API rate limiting can cause failures. Retry or check API usage limits if encountering intermittent errors.

Links and References

Discussion