MediaCockpit PIM icon

MediaCockpit PIM

Interact with MediaCockpit PIM REST API

Overview

This node integrates with the MediaCockpit PIM REST API to create new nodes within a product information management system. Specifically, the "Create Node" operation allows users to add a new node of a specified type under a given parent node, optionally assigning an external key.

Common scenarios for this node include:

  • Automating the creation of product categories or items in a PIM system.
  • Structuring hierarchical data by programmatically adding child nodes.
  • Integrating external systems that generate or manage product data, pushing new nodes into MediaCockpit PIM.

For example, a user might create a new product node of type NT_SHOP_ART under a category node identified by its ID, optionally tagging it with an external reference key for synchronization purposes.

Properties

Name Meaning
Node Type Type of the node to create (e.g., NT_SHOP_ART). Defines what kind of entity the node represents.
Parent Node ID ID or key of the parent node under which the new node will be created.
External Key Optional external key for the new node, useful for linking or referencing outside systems.

Output

The node outputs an array of JSON objects, each representing the result of a create operation per input item. Each output object contains:

  • success: Boolean indicating if the node creation was successful.
  • nodeType: The type of the node created.
  • parentNodeId: The ID/key of the parent node.
  • externalKey: The optional external key provided.
  • response: The raw response from the MediaCockpit PIM API.
  • _debug_create_url: The full URL used for the create request (for debugging).
  • _debug_body: The multipart form-data body sent in the request (for debugging).

No binary data is produced by this node.

Dependencies

  • Requires an API authentication credential to access the MediaCockpit PIM REST API.
  • The node expects the base API URL and session management handled via credentials.
  • HTTP requests are made using n8n's built-in helper methods.
  • The node uses multipart/form-data POST requests to send node creation data.

Troubleshooting

  • Create node failed: [error message]
    This error indicates the API request to create the node was unsuccessful. Common causes include invalid node type, incorrect parent node ID, missing or expired API credentials, or network issues.
    Resolution: Verify the node type and parent node ID values, ensure valid API credentials are configured, and check network connectivity.

  • Unknown operation: [operation]
    This occurs if an unsupported operation name is provided. For this node, only predefined operations like "createNode" are supported.
    Resolution: Use one of the supported operations as defined in the node properties.

  • Invalid or missing required parameters
    If required fields such as Node Type or Parent Node ID are empty or invalid, the node will fail.
    Resolution: Ensure all required properties are correctly set before execution.

Links and References

Discussion