Memberspot

Interact with the Memberspot API (powered by agentur-systeme.de)
Join our community

Actions12

Overview

This node integrates with the Memberspot API to manage user-related operations, specifically allowing you to grant an offer to a user by their email address. The "Grant Offer by Email" operation enables you to assign a specific offer (such as a course or membership) to a user identified by their email, optionally including their first and last names and an order ID.

Common scenarios where this node is beneficial include:

  • Automatically enrolling users into courses or memberships after they sign up or make a purchase.
  • Managing user access to offers without requiring manual intervention.
  • Integrating with other systems to synchronize user entitlements based on external triggers.

Practical example:

  • After a user completes a payment in an e-commerce system, use this node to grant them access to the purchased online course by specifying their email and the offer ID.

Properties

Name Meaning
Email The email address of the user to whom the offer will be granted.
Offer Name or ID Select an offer from a list or specify its ID to grant it to the user.
Order ID (Optional) An order identifier associated with granting the offer.
Firstname (Optional) The user's first name, used when granting the offer.
Lastname (Optional) The user's last name, used when granting the offer.

Output

The node outputs JSON data representing the response from the Memberspot API for the grant offer request. This typically includes confirmation details about the granted offer and the user. The output is structured as:

{
  "json": {
    // API response object confirming the granted offer
  },
  "pairedItem": {
    "item": <index_of_input_item>
  }
}

No binary data is produced by this operation.

Dependencies

  • Requires an API key credential for the Memberspot API.
  • The node expects the Memberspot API base URL and API key to be configured in the credentials.
  • Network connectivity to the Memberspot API endpoint is necessary.

Troubleshooting

  • Common issues:

    • Invalid or missing API key credential will cause authentication failures.
    • Incorrect or non-existent offer ID may result in errors from the API.
    • Providing an invalid email format could lead to request rejection.
    • Network issues or incorrect base URL configuration can cause connection errors.

  • Error messages:

    • Errors returned by the Memberspot API are passed through; typical messages might indicate invalid parameters or authorization failures.
    • If the node throws a generic error, verify that all required fields (email, offer ID) are correctly set.
    • To handle errors gracefully, enable "Continue On Fail" in the node settings to process subsequent items even if one fails.

Links and References

Discussion