Fredhopper Product Discovery

Overview

This node interacts with the Fredhopper Product Discovery API to manage category trees among other resources. Specifically, the Create a Category Tree operation allows users to create a new category tree in a specified tenant and environment by sending structured category tree data to the API.

Common scenarios where this node is beneficial include:

• Automating the creation of product category hierarchies for e-commerce platforms.
• Integrating category management workflows into larger automation pipelines.
• Managing multiple environments (e.g., test, production) and tenants programmatically.

Practical example:

• A retailer wants to upload a new category tree structure representing seasonal products to their test environment before going live. Using this node, they can automate the upload of the JSON category tree data directly from their CMS or database.

Properties

Output

The output is a JSON object representing the response from the Fredhopper Product Discovery API after creating the category tree. This typically includes details about the newly created category tree such as its name, version, status, and any metadata returned by the API.

If the creation is successful, the output contains the full API response parsed as JSON. If there is an error, the node may return an error message or an error object depending on the failure mode.

The node does not output binary data for this operation.

Dependencies

• Requires an API key credential for authenticating with the Fredhopper Product Discovery API.
• The node uses Basic Authentication to obtain an OAuth2 access token, then uses Bearer token authentication for subsequent requests.
• The API base URL and credentials must be configured properly in the n8n credentials section.
• Network connectivity to https://items.attraqt.io is required.

Troubleshooting

• Authentication failed: Failed to obtain access token
  Ensure that the API credentials (username, password, auth URL) are correct and have sufficient permissions.

• HTTP request errors (4xx or 5xx)
  Check that the tenant and environment values are valid and that the category tree data JSON is correctly formatted.

• Invalid JSON in Category Tree Data
  The category tree data must be a valid JSON string. Use JSON validators to verify correctness before running the node.

• Operation not supported error
  Confirm that the selected resource is "Category Tree" and the operation is "Create a Category Tree".

• Network issues
  Verify network access to the API endpoint and proxy/firewall settings if applicable.

Links and References

• Fredhopper Product Discovery API Documentation (example placeholder link)
• OAuth2 Client Credentials Flow
• n8n HTTP Request Node Documentation