Teamleader icon

Teamleader

Consume Teamleader API

Actions60

Overview

This node integrates with the Teamleader API to retrieve detailed information about invoices. Specifically, the "Invoices Info" operation fetches details for a single invoice based on its unique ID. This is useful in scenarios where you need to access invoice data programmatically within an automation workflow, such as verifying invoice status, retrieving billing details, or integrating invoice data into other systems like accounting or CRM platforms.

Practical examples include:

  • Automatically fetching invoice details after a payment event to update internal records.
  • Retrieving invoice information to generate custom reports or dashboards.
  • Using invoice data to trigger follow-up actions, such as sending reminders or updating customer accounts.

Properties

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

Output

The node outputs JSON data representing the invoice details returned by the Teamleader API. The structure typically includes all relevant invoice fields such as invoice number, date, customer information, line items, totals, payment status, and other metadata.

If multiple invoices were requested (not applicable here since this operation requires a single ID), the output would be an array of invoice objects. For this operation, the output is a single invoice object.

The node does not output binary data.

Dependencies

  • Requires an OAuth2 API credential configured for Teamleader to authenticate requests.
  • The node makes HTTP POST requests to the Teamleader API endpoint https://api.focus.teamleader.eu with the path corresponding to the selected operation (invoices.info).
  • Proper API permissions are needed to access invoice information.

Troubleshooting

  • No data returned but request was successful: This message indicates that the API call succeeded but no invoice data was found for the given ID. Verify that the invoice ID is correct and exists in Teamleader.
  • No data got returned: This error means the response did not contain expected data. It may indicate an issue with the API or the request parameters.
  • Authentication errors: Ensure the OAuth2 credentials are valid and have not expired.
  • Invalid ID format: Confirm that the invoice ID provided matches the expected format used by Teamleader.
  • If the node is set to continue on fail, errors will be returned as part of the output JSON; otherwise, execution will stop on error.

Links and References

Discussion