Teamleader icon

Teamleader

Consume Teamleader API

Actions60

Overview

The "Add Contact" operation in this node allows users to create a new contact record within the Teamleader system via its API. This is useful for automating the process of adding contacts from other systems or workflows, such as CRM imports, lead generation forms, or event registrations.

Typical scenarios include:

  • Automatically adding new leads captured from a website form into Teamleader as contacts.
  • Syncing contacts from external databases or marketing platforms.
  • Creating contacts programmatically during onboarding processes.

By providing various contact details like name, birthday, language, and marketing consent, users can ensure rich contact profiles are created automatically.

Properties

Name Meaning
First Name The first name of the contact (optional).
Last Name The last name of the contact (required).
Salutation The salutation/title of the contact (e.g., Mr., Ms.) (optional).
Website The contact's website URL (optional).
Birthday The contact's birthday in YYYY-MM-DD format (optional).
Language The preferred language of the contact (optional).
Remarks Additional remarks or notes about the contact (optional).
Marketing Mails Consent Boolean indicating if the contact has consented to receive marketing emails (optional).
Company ID The ID of the company the contact is linked to (required).

Output

The output JSON contains the data returned by the Teamleader API after creating the contact. This typically includes the newly created contact's details such as their unique ID, names, linked company information, and any other fields accepted by the API.

If multiple contacts were processed (in batch), the output will be an array of contact objects.

No binary data output is involved in this operation.

Dependencies

  • Requires an OAuth2 API credential configured for Teamleader with appropriate permissions to add contacts.
  • The node makes HTTP POST requests to the Teamleader API endpoint https://api.focus.teamleader.eu using the /contacts.add operation.
  • Proper API authentication token must be available in n8n credentials.

Troubleshooting

  • Missing Required Fields: If the required "Last Name" or "Company ID" fields are not provided, the API will likely return an error. Ensure these fields are filled.
  • Invalid Date Format: The "Birthday" field must be in YYYY-MM-DD format; otherwise, the API may reject the request.
  • Authentication Errors: If the OAuth2 token is invalid or expired, the node will fail. Refresh or reconfigure the API credentials.
  • API Rate Limits: Excessive requests might trigger rate limiting by Teamleader. Implement retry logic or reduce request frequency.
  • Empty Response: If no data is returned but the request was successful, the node outputs a message indicating this. Verify the API endpoint and parameters.

Links and References

Discussion