LearningSuite icon

LearningSuite

Interact with LearningSuite API (powered by agentur-systeme.de)

Actions56

Overview

This node integrates with the LearningSuite API to manage webhook subscriptions. Specifically, the Update Webhook Subscription operation allows users to modify an existing webhook subscription by changing its target URL or the event type it listens for.

Typical use cases include:

  • Updating the endpoint URL where webhook events are sent after a service migration or endpoint change.
  • Changing the subscribed event type to receive different notifications without creating a new subscription.
  • Managing webhook subscriptions programmatically as part of automated workflows.

For example, if you initially subscribed to "New Login" events but want to switch to "Lesson Completed" events, this operation lets you update that subscription seamlessly.

Properties

Name Meaning
Hook URL The destination URL where webhook events will be sent. Example: https://your-endpoint.com/webhook
Event Type The type of event to subscribe to. Options include:
- Community Post Created
- Community Post Moderated
- Custom Popup Interaction
- Exam Completed
- Exam Graded
- Feedback Created
- Group User Access Changed
- Lesson Completed
- New Login
- Progress Changed
Subscription Name or ID The identifier of the webhook subscription to update. Can be selected from existing subscriptions or specified via expression.

Output

The node outputs JSON data representing the updated webhook subscription details returned by the LearningSuite API. This typically includes confirmation of the subscription ID, updated event type, and hook URL among other metadata.

If the API returns binary data (not indicated here), it would represent raw webhook payloads or related files, but this node primarily deals with JSON responses.

Dependencies

  • Requires a valid API key credential for authenticating with the LearningSuite API.
  • The base URL for the API must be configured in the node credentials.
  • Network access to the LearningSuite API endpoints is necessary.

Troubleshooting

  • Common issues:

    • Invalid or expired API credentials causing authentication failures.
    • Incorrect or unreachable Hook URL leading to webhook delivery failures.
    • Specifying a non-existent subscription ID results in errors when updating.
    • Selecting an unsupported event type or malformed input parameters.

  • Error messages:

    • "No handler for resource "webhook" and operation "updateSubscription": Indicates a misconfiguration or typo in resource/operation selection.
    • API error responses such as 400 Bad Request or 404 Not Found usually mean invalid input or missing subscription.

  • Resolutions:

    • Verify API credentials and permissions.
    • Confirm the Hook URL is publicly accessible and correctly formatted.
    • Use the node’s subscription list loading feature to select valid subscription IDs.
    • Double-check event type values against the provided options.

Links and References

Discussion