Teamleader icon

Teamleader

Consume Teamleader API

Actions60

Overview

The "Update company link" operation in the Contacts resource allows updating the relationship details between a contact and a company within the Teamleader system. This includes modifying the contact's position at the company and whether the contact is marked as a decision maker.

This node operation is useful when you need to maintain accurate and up-to-date information about how contacts are linked to companies, such as updating job titles or roles after organizational changes. For example, if a contact gets promoted or their role changes within a company, this operation can update that information programmatically.

Properties

Name Meaning
Company ID The unique identifier of the company the contact is linked to.
Position The position or job title of the contact within the company (optional).
Decision Maker Boolean flag indicating whether the contact is a decision maker at the company (optional).
ID The unique identifier of the contact whose company link is being updated.

Output

The output is a JSON array containing the response data from the Teamleader API after updating the company link for the contact. The structure depends on the API response but generally includes the updated link information between the contact and the company.

No binary data output is involved in this operation.

Dependencies

  • Requires an OAuth2 API credential configured for Teamleader.
  • The node makes HTTP POST requests to the Teamleader API endpoint https://api.focus.teamleader.eu.
  • Proper permissions and valid IDs for both the contact and company are necessary.

Troubleshooting

  • Common issues:

    • Invalid or missing Company ID or Contact ID will cause the API request to fail.
    • Insufficient permissions or expired OAuth2 token may result in authentication errors.
    • Providing empty or invalid values for optional fields like position or decision maker might be ignored or cause errors depending on API validation.
  • Error messages:

    • "No data got returned": Indicates the API responded without expected data; verify the IDs and parameters.
    • Authentication errors: Check that the OAuth2 credentials are correctly set up and not expired.
    • Validation errors: Ensure all required fields are provided and formatted correctly.

Links and References

Discussion