Creating activities

Activities represent user actions that you want to track and reward. Before recording activities, you need to define the behaviours you want to track.

Step 1: Create a behaviour

First, define what actions you want to track by creating a behaviour:

Bash

curl https://YOUR_DOMAIN_URL/api/v1/acmeinc/behaviours \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data '{
  "name": "Share Content",
  "verb": "share",
  "active": true,
  "coolOff": 60,
  "jsTrackable": false,
  "attrs": {
    "type": "simple"
  }
}'

Sample response:

JSON

{
  "id": "507f1f77bcf86cd799439012",
  "name": "Share Content",
  "verb": "share",
  "active": true,
  ...
}

Step 2: Record an activity

Now you can track when users perform this behaviour:

Bash

curl https://YOUR_DOMAIN_URL/api/v2/acmeinc/activities \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data '{
  "uuid": "user@acme.com",
  "attrs": {
    "type": "behaviour",
    "verb": "share"
  }
}'

Sample response:

JSON

{
  "id": "507f1f77bcf86cd799439011"
}

Key fields explained

For behaviors:

• name: Human-readable name for the behavior
• verb: Unique identifier for the action (e.g., "share", "login", "purchase")
• coolOff: Minimum seconds between activities (prevents spam)

For activities:

• uuid: Links to the user who performed the action
• attrs.verb: Must match a behaviour you've created
• attrs.type: Set to "behaviour" for basic tracking

Success!

You've now created a complete engagement flow: users → behaviours → activities → rewards. The Mambo platform will automatically apply any rules you've configured to award points, badges, or other incentives when activities are recorded.

Next steps

Explore the full API documentation to learn about advanced features like custom rewards, achievements, and analytics.