Sperse icon

Sperse

Sperse CRM enables secure payment processing and affiliate marketing for online businesses
Join our community

Actions6

Overview

This node integrates with Sperse CRM to manage subscriptions. Specifically, the "Subscription - Create" operation allows users to create or update a subscription record in Sperse CRM by associating a contact with a product and specifying billing details.

Common scenarios where this node is beneficial include:

  • Automating subscription creation when a new customer signs up for a service.
  • Synchronizing subscription data from other platforms into Sperse CRM.
  • Managing recurring billing settings programmatically.

For example, an online business can use this node to automatically create a monthly subscription for a client after they complete a purchase on their website, ensuring that the subscription data is immediately available in Sperse CRM for billing and marketing purposes.

Properties

Name Meaning
Contact ID Sperse Contact ID used to identify the client for the subscription.
Product ID Identifier of the product associated with the subscription (optional).
External Contact ID External reference ID for the contact; must be accurate to correctly look up the contact.
Product Code Unique identifier code for the product; required to correctly identify the product.
Payment Period Type Billing period type for the subscription. Options: Monthly, Annual, LifeTime.
Is It Recurring Billing Indicates if the subscription has recurring billing enabled. Options: Yes, No.

Output

The output JSON contains the response from the Sperse CRM API after attempting to create or update the subscription. This typically includes confirmation of the subscription details or error information if the operation failed.

No binary data output is produced by this node.

Dependencies

  • Requires an active Sperse CRM API credential configured in n8n to authenticate requests.
  • The node uses the Sperse CRM REST API endpoint /api/services/CRM/OrderSubscription/Update with HTTP PUT method to create or update subscriptions.

Troubleshooting

  • Common issues:

    • Incorrect or missing Contact ID or Product Code will cause the API to fail to locate the relevant records.
    • Providing an invalid External Contact ID may result in lookup failures.
    • Mismatched Payment Period Type that does not correspond to the product's configuration in Sperse CRM can cause errors.
    • Network or authentication errors if the API key credential is invalid or expired.

  • Error messages:

    • Errors returned from the Sperse API will typically indicate missing or invalid parameters.
    • Authentication errors suggest checking the API credentials.
    • Validation errors related to product or contact IDs require verifying those values exist in Sperse CRM.

To resolve these issues, ensure all required fields are correctly filled, verify the API credentials, and confirm that referenced contacts and products exist in Sperse CRM with matching identifiers.

Links and References

Discussion