Teamleader icon

Teamleader

Consume Teamleader API

Actions60

Overview

This node integrates with the Teamleader API to update company information. It allows users to modify details of an existing company record in Teamleader, such as its name, business type, contact details, addresses, and other relevant metadata.

Common scenarios where this node is beneficial include:

  • Synchronizing updated company data from another system into Teamleader.
  • Automating updates to company records based on workflow triggers (e.g., when a company changes status or contact info).
  • Bulk updating multiple companies' information programmatically.

Practical example:

  • A workflow that listens for changes in a CRM system and updates corresponding company records in Teamleader with new email addresses, phone numbers, or VAT numbers.

Properties

Name Meaning
Name The name of the company (required).
Business Type ID The business type identifier of the company (optional).
VAT Number The VAT number of the company (optional).
Emails Multiple email addresses associated with the company. Each email has a type (Primary or Secondary) and an email address (required).
Addresses Multiple addresses related to the company. Each address includes type (Invoicing or Shipping), addressee, line 1 (required), postal code, city, and country.
Telephones Multiple telephone numbers for the company. Each telephone has a type (Phone or Mobile) and a number (required).
Website The company's website URL (optional).
IBAN The International Bank Account Number of the company (optional).
BIC The Bank Identifier Code of the company (optional).
Language The language setting of the company (optional).
Remarks Additional remarks or notes about the company (optional).
Tags Tags associated with the company. Multiple tags can be selected from a dynamically loaded list (optional).
Marketing Mails Consent Boolean indicating whether the company has consented to receive marketing emails (optional).
Preferred Currency The preferred currency for the company. Options include BAM, CAD, CHF, CLP, CNY, COP, CZK, DKK, EUR, GBP, INR, ISK, JPY, MAD, MXN, NOK, PEN, PLN, RON, SEK, TRY, USD, ZAR (optional). Defaults to EUR.
ID The unique identifier of the company to update (required).

Output

The node outputs a JSON array containing the response data from the Teamleader API after updating the company. The structure typically reflects the updated company object returned by the API, including all fields that were modified or retrieved.

No binary data output is involved.

Dependencies

  • Requires an OAuth2 API credential configured for Teamleader with appropriate permissions to update company data.
  • The node communicates with the Teamleader API endpoint at https://api.focus.teamleader.eu using POST requests.
  • The environment must have internet access to reach the Teamleader API.

Troubleshooting

  • No data returned but request was successful: This message indicates the API call succeeded but no data was returned. Verify that the company ID is correct and that the API supports returning data for the update operation.
  • No data got returned: This error occurs if the API response lacks expected data. Check network connectivity, API credentials, and ensure required parameters are provided.
  • Invalid or missing company ID: The update operation requires a valid company ID. Ensure the "ID" property is set correctly.
  • Permission errors: If the API returns authorization errors, verify that the OAuth2 credentials have sufficient rights to update company records.
  • Validation errors: Providing invalid values for properties like emails, addresses, or currency may cause API validation failures. Double-check input formats and required fields.

Links and References

Discussion