Skip to main content

Users

Users represent individuals who engage with your strategy in Mambo. Whether they're customers, employees, partners, sports fans, or citizens, effective user management is crucial for your engagement strategy.

Key user fields​

Understanding the essential user fields helps you manage user data effectively:

Unique user ID (UUID)​

The UUID is your primary identifier for all API interactions. Choose a UUID that matches your existing unique identifiers, for example:

  • For customers: email address
  • For employees: employee number
  • For partners: partner ID

Example UUID usage:

HTTP

Member status​

The member field controls participation in the engagement strategy:

  • Set to "Yes" in the UI or true in the API to enable participation
  • Users can opt-in/opt-out via API if self-selection is desired
  • Non-members cannot earn points or receive rewards

Personal information​

Core identification fields used across the platform:

  • First name and last name: Displayed in widgets, leaderboards, and activity streams
  • Email: Used for communications and notifications

Creating users​

API integration​

The most common method is via the POST User API. This approach:

  • Integrates with your existing user repository
  • Enables automated user creation

LDAP or SAML directory integration​

Connect to your LDAP or SAML User Directory to:

  • Enable direct Mambo login
  • Auto-create users on first login

Manual creation​

Create test users directly from the Users page to:

  • Test your engagement strategy
  • Create sample users for demonstrations
  • Validate reward configurations

Searching users​

When you search for a user, the system checks the UUID, email, first name, last name and display name of the user to find matches.

Sorting users​

You can sort users by clicking on the column headers in the user table. Each sortable column is clickable:

  • First click: sorts in ascending order
  • Second click: sorts in descending order

Filtering users​

The user table can be filtered by tag. Open the tag filter from the table toolbar and select one or more tags. The filter returns users that match any of the selected tags.

Customising the display​

The user table provides you with the ability to select which columns you would like to display. The Columns button in the top right-hand corner of the table allows you to select the columns.

Accessing user details​

To view detailed information about a specific user, click on the View option found under Actions. This will take you to the user details page with comprehensive information about the user.

Data privacy considerations​

Anonymised users​

When handling sensitive data:

  • Use pseudonymised values for personal fields
  • Maintain UUID mapping in your system
  • Use API responses to display correct values in your application

Troubleshooting​

Common issues and solutions:

  • Duplicate UUID: Ensure unique identifiers across your user base
  • Invalid email format: Validate email addresses before creation
  • Member status conflicts: Check user opt-in status
  • Missing required fields: Verify all mandatory fields are provided