Teamleader icon

Teamleader

Consume Teamleader API

Actions60

Overview

This node integrates with the Teamleader API to retrieve information about subscriptions, specifically supporting the "Info" operation for the Subscriptions resource. It fetches detailed data for a single subscription based on its unique ID. This is useful in scenarios where you need to access or verify subscription details within an automated workflow, such as checking subscription status before processing billing or customer management tasks.

Practical examples:

  • Retrieve subscription details to update customer records.
  • Verify subscription status before granting access to services.
  • Automate reporting by fetching subscription info regularly.

Properties

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

Output

The node outputs a JSON object containing the detailed information of the specified subscription as returned by the Teamleader API. The structure corresponds directly to the API's subscription data schema and typically includes fields such as subscription ID, status, start and end dates, associated customer, plan details, and other metadata.

No binary data output is produced by this operation.

Dependencies

  • Requires an OAuth2 API credential configured for Teamleader with appropriate permissions to access subscription data.
  • The node makes HTTP POST requests to the Teamleader API endpoint https://api.focus.teamleader.eu using the /subscriptions.info operation path.
  • Proper API authentication token must be provided via the configured OAuth2 credentials.

Troubleshooting

  • Common issues:

    • Missing or invalid subscription ID will cause the API request to fail.
    • Expired or incorrect OAuth2 credentials will result in authentication errors.
    • Network connectivity problems can prevent successful API calls.
  • Error messages:

    • "No data got returned": Indicates that the API response did not contain expected data; verify the subscription ID and API availability.
    • Authentication errors: Check that the OAuth2 credentials are valid and have not expired.
    • Request failures: Inspect error messages for HTTP status codes and ensure the API endpoint is reachable.

To resolve these issues, confirm the subscription ID is correct, refresh or reconfigure API credentials, and ensure network access to the Teamleader API.

Links and References

Discussion