Printcart icon

Printcart

Consume Prinrcart API
Join our community

Actions83

Overview

This node integrates with the Printcart API to manage "Sides" of products in a print-on-demand or custom product design context. Specifically, the "Create Side" operation allows users to add a new side to an existing product by specifying details such as background type, color, scale, image size, design area dimensions, and status.

Use cases include:

  • Adding a new printable side (e.g., front, back, sleeve) to a customizable product.
  • Defining visual and layout properties for that side to control how designs appear.
  • Managing product sides programmatically within automated workflows.

For example, a user can create a new side named "Front" for a T-shirt product, set its background color to white, specify the scale and image dimensions, and mark it as published.

Properties

Name Meaning
Authentication Method of authentication; currently supports "API Token".
Product ID The unique identifier of the product to which the side will be added.
Name of the Side The name assigned to the side (e.g., "Front", "Back").
Background Type The type of background for the side; options are: Color, Image, Transparent.
Background Color Value The color value used for the side's background (required).
Scale The scale factor for the side (percentage).
Width Width dimension of the side image size.
Height Height dimension of the side image size.
Width Arena Width of the design arena area on the side.
Height Arena Height of the design arena area on the side.
Top Arena Top offset position of the design arena area.
Left Arena Left offset position of the design arena area.
Side Image ID Identifier of the side image associated with this side (required).
Status Status of the side; options are Publish, Draft, Trashed (required).

Output

The node outputs JSON data representing the response from the Printcart API after creating the side. This typically includes all details of the newly created side such as its ID, name, background settings, scale, image sizes, design arena dimensions, associated image IDs, and status.

No binary data output is involved.

Dependencies

  • Requires an API token credential for authenticating requests to the Printcart API.
  • The node uses HTTP requests to the Printcart API endpoints over HTTPS.
  • No additional external dependencies beyond the API access and credentials.

Troubleshooting

  • Authentication errors: Ensure the provided API token is valid and has sufficient permissions.
  • Missing required fields: The node requires productId, name, bg_color_value, scale, side_image_id, and status to be set. Omitting these will cause API errors.
  • Invalid values: Providing invalid color codes, non-numeric scale, or incorrect image IDs may result in request failures.
  • API connectivity issues: Network problems or incorrect API endpoint URLs can cause request timeouts or failures.
  • Error messages: The node surfaces error messages returned by the API. Review these messages for clues, such as "Unauthorized", "Not Found", or validation errors, and adjust inputs accordingly.

Links and References

Discussion