Teamleader icon

Teamleader

Consume Teamleader API

Actions67

Companies → Update

AI-generated

Overview

This node operation updates an existing company in the Teamleader system using the Teamleader API. It allows users to modify various company details such as name, business type, VAT number, emails, addresses, telephones, website, banking information, language, remarks, tags, marketing consent, and preferred currency. This operation is useful for keeping company records up-to-date in CRM workflows or automation scenarios where company information changes need to be synchronized automatically.

Use Case Examples

  1. Updating a company's contact details after receiving new information from a client.
  2. Changing the preferred currency or business type of a company based on updated financial data.
  3. Adding or modifying company addresses and telephone numbers to ensure accurate communication channels.

Properties

Name Meaning
Name The name of the company. This is a required field for updating a company.
Business Type ID The business type ID of the company, used to categorize the company by its business type.
VAT Number The VAT number of the company, used for tax identification.
Emails A collection of email addresses associated with the company, each with a type (primary or secondary) and an email address.
Addresses A collection of addresses for the company, each with a type (invoicing or shipping), addressee, line 1, postal code, city, and country.
Telephones A collection of telephone numbers for the company, each with a type (phone or mobile) and a number.
Website The website URL of the company.
IBAN The IBAN (International Bank Account Number) of the company for banking purposes.
BIC The BIC (Bank Identifier Code) of the company for banking purposes.
Language The language setting of the company.
Remarks Additional remarks or notes about the company.
Tags Tags associated with the company, allowing multiple tags to be added for categorization or filtering.
Marketing Mails Consent Boolean indicating whether the company has given consent to receive marketing emails.
Preferred Currency The preferred currency of the company, selectable from a list of currency codes.
ID The unique identifier of the company to update. This is a required field to specify which company record to modify.

Output

JSON

  • id - The unique identifier of the updated company.
  • name - The name of the updated company.
  • business_type_id - The business type ID of the updated company.
  • vat_number - The VAT number of the updated company.
  • emails - The list of email addresses associated with the updated company.
  • addresses - The list of addresses associated with the updated company.
  • telephones - The list of telephone numbers associated with the updated company.
  • website - The website URL of the updated company.
  • iban - The IBAN of the updated company.
  • bic - The BIC of the updated company.
  • language - The language setting of the updated company.
  • remarks - Additional remarks or notes about the updated company.
  • tags - Tags associated with the updated company.
  • marketing_mails_consent - Indicates if the company has consented to receive marketing mails.
  • preferred_currency - The preferred currency of the updated company.

Dependencies

  • Teamleader API OAuth2 credentials

Troubleshooting

  • Ensure the company ID provided is valid and exists in the Teamleader system to avoid 'No data got returned' errors.
  • Verify that required fields like 'Name' and 'ID' are provided; missing these will cause the update to fail.
  • Check API authentication credentials are correctly configured and valid to prevent authorization errors.
  • If the API returns no data, confirm that the request body is correctly structured and all required parameters are included.

Links

Discussion