Skip to main content

Introduction

The Mambo API enables you to build engagement and reward systems that motivate users through automated rules and incentives. Track user activities, apply business rules, and deliver rewards to drive specific behaviours within your applications.

Prerequisites​

  • Mambo account with API access
  • Your public and private API keys (available in your administration panel)
  • Basic knowledge of REST APIs and OAuth 2.0

Base URL​

All API requests are made to: https://api.mambo.io/api

Authentication​

The Mambo API uses OAuth 2.0 Client Credentials flow. You'll authenticate using your API keys to receive a Bearer token, then include this token in all subsequent API requests.

Core concepts​

  • Users: Individuals, teams, or groups you want to motivate (users, employees, customers, partners)
  • Activities: User actions or metrics you want to track and reward (e.g. log ins, sales, completions, performance data)
  • Rules: Logic that determines when and how to award rewards based on activities
  • Rewards: Incentives that motivate desired behaviours and drive engagement

For more information visit our Glossary of Concepts

What you'll build​

In this guide, you'll create a basic user, record an activity for them, and see how the platform can automatically apply rules and rewards to drive engagement.