User management

Users are the foundation of your engagement strategy. Let's create your first user and learn how to retrieve their information.

Creating a user

To create a user, you need just a few essential fields: a unique identifier (uuid) and basic details like email and name.

Bash

curl https://YOUR_DOMAIN_URL/api/v1/acmeinc/users \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data '{
  "uuid": "user@acme.com",
  "details": {
    "email": "user@example.com",
    "firstName": "John",
    "lastName": "Doe"
  }
}'

Sample response:

JSON

{
  "id": "65d3a6f1d7c4a2e8f5b9b2d6",
  "uuid": "user@acme.com",
  "details": {
    "email": "user@example.com",
    "firstName": "John",
    "lastName": "Doe"
  },
  ...
}

Retrieving a user

Use the user's uuid from the creation response to retrieve their information:

Bash

curl https://YOUR_DOMAIN_URL/api/v1/acmeinc/users/user@acme.com \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

This returns the complete user object.

Key fields explained

• uuid: Your unique identifier for the user (often email or internal ID)
• details.email: User's email address
• details.firstName/lastName: User's name for personalization
• id: Mambo's internal ID for API operations

Next steps

Now that you have a user, let's create some activities to start tracking their engagement!