LearningSuite icon

LearningSuite

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

Overview

The "Find or Create Member" operation in the Member resource allows you to either retrieve an existing member by their email address or create a new member if one does not already exist. This is useful in scenarios where you want to ensure a member record exists without manually checking first, such as onboarding new users, synchronizing user data from other systems, or automating membership management workflows.

Practical examples include:

  • Automatically adding a new user to your LearningSuite platform when they sign up on your website.
  • Checking if a user exists before sending them targeted communications or granting access.
  • Creating members with additional profile details like name, phone, and position in one step.

Properties

Name Meaning
Email The email address of the member to find or create. This is required and used as the unique identifier for lookup.
First Name The first name of the member to create if no existing member is found. Required when creating a new member.
Last Name The last name of the member to create if no existing member is found. Required when creating a new member.
Additional Options A collection of optional fields to provide more information about the member when creating:
- About Text describing the member.
- City The city where the member is located.
- Do Not Require Password Change If enabled, the member will not be prompted to change their password upon first login. Intended for members logging in via Single Sign-On (SSO). Default behavior is to require password change for privacy.
- Do Not Send Welcome Email If enabled, the member will not receive a welcome email containing a pre-signed login link.
- Ignore If Already Exists If enabled, avoids throwing an error when attempting to create a member that already exists.
- Locale The user interface language preference for the member. Options are German ("de") or English ("en").
- Password The password for the member account.
- Phone The phone number of the member.
- Position The job title or position of the member.

Output

The node outputs an array of JSON objects representing the member(s) found or created. Each object contains the member's details as returned by the LearningSuite API, including at least the email and name fields, and any additional properties set or retrieved.

If binary data were involved (e.g., profile pictures), it would be included in a separate binary property, but this operation focuses on JSON data only.

Dependencies

  • Requires a valid API key credential configured in n8n to authenticate with the LearningSuite API.
  • The base URL for the API must be set in the credentials configuration.
  • Internet connectivity to reach the LearningSuite API endpoint.

Troubleshooting

  • Error: No handler for resource "member" and operation "findOrCreate"
    This indicates a misconfiguration or typo in the resource or operation parameters. Verify that "Member" is selected as the resource and "Find or Create Member" as the operation.

  • API authentication errors
    Ensure the API key credential is correctly configured and has sufficient permissions.

  • Member already exists error
    If the "Ignore If Already Exists" option is not enabled and a member with the given email exists, the node may throw an error. Enable this option to avoid failure in such cases.

  • Missing required fields
    The email is always required. When creating a member, first and last names are also mandatory. Make sure these fields are provided.

Links and References

Discussion