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 interacts with the Teamleader API to retrieve information about custom field definitions. Specifically, the "Custom Fields" resource with the "Info" operation fetches detailed information about a single custom field definition by its ID. This is useful when you need to access metadata or configuration details of a specific custom field within your Teamleader account.
Common scenarios include:
- Retrieving the schema or settings of a particular custom field to dynamically build forms or validate data.
- Integrating with other systems where knowledge of custom field properties is required.
- Auditing or reporting on custom fields used in your CRM setup.
Example: You want to get details about a custom field with ID abc123 to understand its type and options before updating records that use this field.
Properties
| Name | Meaning |
|---|---|
| ID | The unique identifier of the custom field definition to retrieve information about. This is a required string input. |
Output
The node outputs JSON data representing the detailed information of the specified custom field definition. The structure typically includes properties such as the field's ID, name, type, possible values (if applicable), and other metadata describing the custom field.
If multiple items were returned (not typical for an info operation), they would be output as an array; however, for the "Info" operation, a single object is expected.
No binary data output is produced by this operation.
Dependencies
- Requires an OAuth2 API credential configured for Teamleader to authenticate requests.
- The node makes HTTP POST requests to the Teamleader API endpoint at
https://api.focus.teamleader.eu. - Proper permissions in the Teamleader account are necessary to access custom field definitions.
Troubleshooting
- No data returned but request was successful: This message indicates the API call succeeded but no data was found for the given ID. Verify that the provided ID is correct and exists in your Teamleader account.
- No data got returned: This error means the response did not contain the expected data property. It could indicate an invalid ID or permission issues.
- Authentication errors: Ensure the OAuth2 credentials are valid and have not expired.
- Rate limiting or API errors: If the API returns errors, check the Teamleader API status and your usage limits.
To resolve these issues:
- Double-check the ID input.
- Confirm API credentials and permissions.
- Review Teamleader API documentation for any changes or limitations.
Links and References
- Teamleader API Documentation
- Teamleader Custom Field Definitions API (for detailed API reference)