Actions6
Overview
This node integrates with a recurring and one-time payments platform, allowing users to create various resources such as contacts, invoices, products, and subscriptions. Specifically, the Product Create operation enables users to add new products into the system with detailed attributes including pricing, subscription options, and descriptive information.
Typical use cases include:
- Adding new products to an e-commerce or subscription management system.
- Defining product pricing and billing cycles for digital goods, events, or subscriptions.
- Managing product metadata like descriptions, logos, and grouping for catalog organization.
For example, a user can create a "Subscription" type product with monthly billing cycles and trial periods, or a "General" product with a fixed price and unit measurement.
Properties
| Name | Meaning |
|---|---|
| Product Type | The category of the product. Options: General, Event, Subscription, Digital. Determines how the product is handled on the platform. |
| Product Name | The name/title of the product. |
| SKU | The stock keeping unit or product code, uniquely identifying the product. |
| Description | A plain text description of the product. |
| Description HTML | An HTML-formatted description (without JavaScript or media tags) for richer content display. |
| Logo Url | URL pointing to the product's logo image. |
| Group Name | A grouping label to categorize the product within a collection or catalog. |
| Price | The product price. Required for General, Digital, and Event product types. |
| Currency ID | The currency in which the price is denominated. Options include AUD, CAD, CHF, CNY, EUR, GBP, IND, JPY, NZD, SEK, USD. |
| Unit | The unit of measure for the product quantity. Required for General and Digital product types. Options include Custom, Day, Feet, Hour, Kilogram, Month, Package, Piece, Pound, Unit, Year, Zone. |
| Payment Cycle | The billing frequency for subscription-type products. Required for General and Digital product types. Options: Annual, Custom, LifeTime, Monthly, OneTime. |
| Subscription Fee | The recurring fee amount for subscription products. |
| No of Cycles | Number of billing cycles for the subscription. Required except for LifeTime or OneTime plans. |
| Signup Fee | Initial signup fee charged when subscribing. Required except for LifeTime or OneTime plans. |
| Custom Period Type | The custom period unit for billing cycles when using Custom or OneTime plans. Options: Days, Months, Weeks, Years. |
| Custom No of Period | The number of custom periods for billing cycles when using Custom or OneTime plans. |
| Trial Day Count | Number of trial days offered before billing starts. Required for OneTime plans. |
| Grace Period Count | Number of grace days allowed after a billing cycle ends before suspension or cancellation. |
Output
The node outputs JSON data representing the created product as returned by the external API. This typically includes all submitted fields along with any additional metadata or identifiers assigned by the service.
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential for authenticating requests to the external payment and subscription management service.
- The node uses an internal helper function to make HTTP POST requests to the endpoint
/api/services/CRM/Import/ImportProduct. - Proper configuration of the API credential in n8n is necessary for successful execution.
Troubleshooting
- Missing required fields: Ensure all mandatory properties such as Product Type, Product Name, SKU, Currency ID, Unit, and Payment Cycle are provided according to the product type.
- Invalid field values: For example, providing a price for a Subscription product without a valid payment cycle may cause errors.
- API authentication errors: Verify that the API key credential is correctly configured and has sufficient permissions.
- HTML description restrictions: Avoid including JavaScript or media tags in the Description HTML field to prevent validation failures.
- Network or service downtime: Temporary connectivity issues with the external API will result in request failures; retry after some time.
Links and References
- ChargeKeep Official Website — For general product and API documentation.
- Stripe Documentation — Since ChargeKeep integrates with Stripe, useful for understanding payment flows.
- PayPal Developer — For PayPal integration details related to recurring payments.