iTwin Component Center icon

iTwin Component Center

Comprehensive iTwin Component Center API

Overview

This node allows you to create a new manufacturer record in the iTwin Component Center system. It is useful when you want to programmatically add manufacturer details such as display name, phone number, address, and website into the Component Center database. Typical use cases include automating the onboarding of new manufacturers or integrating manufacturer data from other systems into the Component Center.

For example, if you have a list of manufacturers in a CRM or ERP system, you can use this node to batch-create those manufacturers in the Component Center without manual entry.

Properties

Name Meaning
Display Name The display name of the manufacturer. Must be a string up to 250 characters and cannot include special characters: >, <, ^, $, ?, `
Phone The phone number of the manufacturer. String with a maximum length of 250 characters.
Address The physical address of the manufacturer. String with a maximum length of 250 characters.
Website The website URL of the manufacturer. String with a maximum length of 250 characters.
Options Additional options for the request. Contains a "Custom Payload" option that allows overriding the entire request body with a custom JSON payload. Useful if you need to send data not covered by the standard fields.

Output

The node outputs an array of JSON objects representing the created manufacturer(s). Each output item contains the response from the API after creating a manufacturer. The exact structure depends on the API response but typically includes identifiers and details of the newly created manufacturer.

No binary data output is produced by this node.

Dependencies

  • Requires an API key or OAuth2 credential configured in n8n to authenticate with the iTwin Component Center API.
  • The node internally uses an OpenAPI interpreter module to handle API requests.
  • Network access to the iTwin Component Center API endpoint is necessary.

Troubleshooting

  • Validation errors: If the display name contains forbidden special characters or exceeds length limits, the API will reject the request. Ensure input values conform to the specified constraints.
  • Authentication failures: Make sure the API credentials are correctly set up and valid.
  • Unknown operation error: If the operation parameter is incorrect or missing, the node throws an error indicating an unknown operation.
  • Custom Payload issues: When using the custom payload option, ensure the JSON is well-formed and matches the expected API schema; otherwise, the API may return errors.

Links and References

Discussion