Teamleader icon

Teamleader

Consume Teamleader API

Actions67

Companies → Add

AI-generated

Overview

This node operation allows users to add a new company to the Teamleader system via the Teamleader API. It is useful for automating the creation of company records in CRM workflows, such as when onboarding new clients or integrating external data sources. Users can specify detailed company information including name, business type, VAT number, emails, addresses, telephones, website, banking details, language, remarks, tags, marketing consent, and preferred currency.

Use Case Examples

  1. Automatically add new client companies from a lead generation form to Teamleader.
  2. Integrate company data from an external database into Teamleader CRM.
  3. Create companies in bulk from a spreadsheet import using n8n workflows.

Properties

Name Meaning
Name The name of the company. This is a required field when adding 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, useful for tax and billing purposes.
Emails A collection of email addresses for the company, each with a type (primary or secondary) and the email address itself.
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 the number itself.
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 categorization or labeling with multiple tags.
Marketing Mails Consent Boolean indicating whether the company has consented to receive marketing emails.
Preferred Currency The preferred currency for the company, selected from a list of currency codes.

Output

JSON

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

Dependencies

  • Teamleader API OAuth2 authentication

Troubleshooting

  • Ensure the required 'Name' field is provided; missing it will cause the API request to fail.
  • Verify that the OAuth2 credentials for Teamleader API are correctly configured and authorized.
  • If the API returns no data, check the request payload for missing or invalid fields.
  • Handle API errors gracefully by enabling 'Continue On Fail' in n8n to avoid workflow interruption.

Links

Discussion