LearningSuite icon

LearningSuite

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

Actions56

Overview

The "Find or Create Member" operation in the Member resource allows you to either locate 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 system when they sign up via a form.
  • Checking if a user already exists before sending them targeted communications.
  • Integrating with external CRM or membership platforms to keep member records up-to-date.

Properties

Name Meaning
Email The email address of the member to retrieve or create. This is required and used as the unique identifier for lookup.
First Name The first name of the member to create (required when creating a new member).
Last Name The last name of the member to create (required when creating a new member).
Additional Options A collection of optional fields to provide more details about the member when creating:
- About Text describing the member.
- City The city where the member resides.
- Do Not Require Password Change If enabled, the member will not be prompted to change their password on first login. Intended for members who log in via Single Sign-On (SSO) and have no set password. Defaults to false.
- Do Not Send Welcome Email If enabled, the member will not receive a welcome email containing a pre-signed login link. Defaults to false.
- Ignore If Already Exists If enabled, avoids throwing an error when attempting to create a member that already exists. Defaults to false.
- Locale The user interface language preference for the member. Options are German ("de") or English ("en"). Defaults to German.
- 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 information provided or retrieved.

If the operation creates a new member, the output reflects the newly created member's data. If it finds an existing member, the output contains that member's data.

The node does not output binary data.

Dependencies

  • Requires a valid API key credential for the LearningSuite API.
  • The base URL for the API must be configured in the node credentials.
  • The node depends on the LearningSuite API being accessible and responsive.

Troubleshooting

  • No handler for resource and operation: If you see an error indicating no handler exists for the specified resource-operation pair, verify that you selected "Member" as the resource and "Find or Create Member" as the operation.
  • API authentication errors: Ensure your API key credential is correctly configured and has sufficient permissions.
  • Member already exists error: If you attempt to create a member that already exists without enabling "Ignore If Already Exists," the node may throw an error. Enable this option to avoid such errors.
  • Missing required fields: Make sure to provide the required fields like Email, First Name, and Last Name when creating a member.
  • Network or API errors: Check network connectivity and API status if requests fail unexpectedly.

Links and References

Discussion