LearningSuite icon

LearningSuite

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

Actions56

Overview

This node interacts with the LearningSuite API to update an existing webhook subscription. It allows users to modify the URL where webhook events are sent and change the type of event they want to subscribe to. This is useful when you need to redirect webhook notifications to a new endpoint or adjust which events trigger those notifications without creating a new subscription from scratch.

Common scenarios:

  • Changing the destination URL for webhook events after migrating your receiving service.
  • Updating the event type to listen for different activities, such as switching from "New Login" events to "Exam Completed" events.
  • Managing webhook subscriptions dynamically within an automation workflow.

Practical example:
You have a webhook subscription sending "New Login" events to https://old-endpoint.com/webhook. After updating your backend, you want these events to go to https://new-endpoint.com/webhook instead. Using this node's "Update Webhook Subscription" operation, you specify the subscription ID, set the new hook URL, and optionally change the event type if needed.

Properties

Name Meaning
Hook URL The URL where webhook events will be sent. Must be a valid HTTPS endpoint (e.g., 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 a list of existing subscriptions or specified via an expression.

Output

The node outputs a JSON array containing the updated webhook subscription details returned by the LearningSuite API. Each item in the output corresponds to one updated subscription object, typically including fields such as subscription ID, event type, hook URL, status, and other metadata related to the webhook subscription.

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

Dependencies

  • Requires a valid API key credential for authenticating with the LearningSuite API.
  • The node expects the base URL of the LearningSuite API to be configured in the credentials.
  • Network access to the LearningSuite API endpoints must be available.
  • No additional external dependencies beyond the LearningSuite API and n8n core modules.

Troubleshooting

  • Common issues:

    • Invalid or missing subscription ID: Ensure the subscription ID exists and is correctly selected or provided.
    • Incorrect hook URL format: The hook URL must be a valid HTTPS URL; otherwise, the API may reject the request.
    • Insufficient permissions: The API key used must have rights to update webhook subscriptions.
    • Network connectivity problems: Verify that n8n can reach the LearningSuite API endpoint.

  • Error messages:

    • "No handler for resource "webhook" and operation "updateSubscription": Indicates a misconfiguration or unsupported operation; verify the resource and operation names.
    • API errors returned from LearningSuite (e.g., 400 Bad Request): Check the input parameters for correctness.
    • NodeOperationError with message about invalid subscription ID or URL: Review the inputs carefully.

To resolve errors, double-check all input properties, ensure credentials are valid, and consult the LearningSuite API documentation for any constraints on webhook updates.

Links and References

Discussion