Actions60
- User Actions
- Teams Actions
- Custom Fields Actions
- Tickets Actions
- Deals Actions
- Webhooks Actions
- Contacts Actions
- Companies Actions
- Bussiness Types Actions
- Tags Actions
- Deal Phases Actions
- Invoices Actions
- Subscriptions Actions
- Products Actions
- Projects Actions
- Tasks Actions
- Files Actions
Overview
This node integrates with the Teamleader API to manage company data. Specifically, the "Companies - Add" operation allows users to create a new company record in their Teamleader account by providing detailed company information.
Common scenarios where this node is beneficial include:
- Automating the creation of company records when new leads or clients are added from other systems.
- Synchronizing company data between Teamleader and external CRMs or databases.
- Streamlining onboarding processes by programmatically adding companies with all relevant details.
For example, a user can set up a workflow that triggers when a new company signs up on their website, automatically adding that company to Teamleader with its name, contact emails, addresses, phone numbers, VAT number, and preferred currency.
Properties
| Name | Meaning |
|---|---|
| Name | The name of the company (required). |
| Business Type ID | The business type identifier for the company (optional). |
| VAT Number | The VAT number of the company (optional). |
| Emails | One or more email addresses associated with the company. Each email has a type ("Primary" or "Secondary") and an email address (required). |
| Addresses | One or more addresses for the company. Each address includes type ("Invoicing" or "Shipping"), addressee, line 1 (required), postal code, city, and country. |
| Telephones | One or more telephone numbers. 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 for the company (optional). |
| Remarks | Additional remarks or notes about the company (optional). |
| Tags | Tags associated with the company. Multiple tags can be selected from available options. |
| Marketing Mails Consent | Boolean indicating whether the company has consented to receive marketing emails (optional). |
| Preferred Currency | The preferred currency for transactions with the company. Options include common currencies such as EUR, USD, GBP, JPY, CAD, etc. Defaults to EUR if not specified. |
Output
The node outputs JSON data representing the newly created company as returned by the Teamleader API. This typically includes the company's unique ID, name, and all other provided details confirmed by the API.
If multiple items are processed, the output is an array of such company objects.
No binary data output is produced by this operation.
Dependencies
- Requires an OAuth2 API credential configured for Teamleader with appropriate permissions to create companies.
- The node makes HTTP POST requests to the Teamleader API endpoint at
https://api.focus.teamleader.eu. - The API token must have rights to add company records.
Troubleshooting
- No data returned but request was successful: This message indicates the API call succeeded but no company data was returned. Verify that required fields like "Name" are correctly set.
- No data got returned: This error means the response did not contain expected data. Check API credentials and network connectivity.
- API errors: If the API returns errors (e.g., invalid input, authentication failure), the node will throw an error unless "Continue On Fail" is enabled.
- Ensure all required fields are provided; missing mandatory fields like "Name" will cause the API to reject the request.
- For multi-value properties (emails, addresses, telephones), ensure at least one valid entry is provided if used.
Links and References
- Teamleader API Documentation
- Teamleader official site: https://www.teamleader.eu/