Importing User Data


Once you’ve loaded your product catalog and interaction data, you can optionally include user data. This is where you can provide demographic information about your users that isn’t represented in the interaction data, such as age, gender, and country. Miso will use this information to find correlations between the attributes and user behaviors to improve the Search and Recommendation engine quality. Miso has a standard set of user attributes, but you can also define any custom_attributes that relate to your users.

Sample Record

Below is a sample user record:

    "user_id": "user_1234",
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z",
    "name": "John Doe",
        "profile_image": "",
    "age": 33,
    "gender": "M",
    "city": "Mountain View",
    "state": "California",
    "country": "US",
    "group_id": "Northwind Corp",
    "description": "Engineer from Northwind Corp",
    "custom_attributes": {
        "acquisition_channel": "Facebook Campaign 2020",
        "declared_interests": [

Figure 1 - The list of supported user attributes

Importing User Data using APIs

User data can be imported using the Users API. The basic call pattern looks like below, with each user in the array following the schema shown in Figure 1:

POST /v1/users
    "data": [

Figure 2 - A basic call pattern for the Users API

Here’s what a sample request might look like using JavaScript:

const apiKey = "<your private api key>"
const url = `${apiKey}`

// user objects are wrapped inside {"data": [...]}
// "user_id" is the unique identifier to the user
const payload = [
        "user_id": "user_123",
        "gender": "Female",
        "age": 25,
        "name": "Jane Doe",
        "city": "Mountain View",
        "state": "CA",
        "country": "United States",
        "created_at": "2019-08-24"

fetch(url, {
    method: "POST",
    headers: {
      "Content-Type": "application/json"
    body: payload
.then(response => response.json())

Figure 3 - A JavaScript example of an API request to Miso

Importing User Data Using an Integration

Miso integrates with popular databases and S3/SFTP to import user data. Please see the full list of integrations and instructions here.

Importing User Data Using Dojo

Dojo provides an intuitive, no-code UI for managing your Miso data sets and engines.

The recommended method for importing user data is either via the Users API or an integration. However, if you are more comfortable using a point-and-click UI, you can upload a JSON file containing a list of users directly through Dojo.

  1. From the left navigation pane of the Dojo Dashboard, under the Data sets category, select Users.

    Figure 4 - Dojo navigation pane

  2. Select Import data file and either drag and drop the JSON file, or click in the designated area to upload a file from a file browser.

    Figure 5 - Importing a data file in Dojo

  3. Select Next step.

  4. A progress bar will appear as the user data is loaded into Miso. When it’s at 100%, select Next step.

  5. If the data load is successful, you will be taken to a dashboard where you can view the uploaded data.

    Figure 6 - User data dashboard in Dojo

Next: Training Your First Engine

Icon/Activity Icon/Add Icon/API Icon/Arrow/Down Icon/Arrow/Left Icon/Arrow/Right Icon/Arrow/TopRight Icon/Arrow/Up Icon/Bento Icon/Billing Icon/Bin Icon/Book Icon/Bookmark/Default Icon/Bookmark/Filled Icon/Calendar Icon/Caret/Down Icon/Caret/Up Icon/Chavron/DownIcon/Chavron/LeftIcon/Chavron/RightIcon/Chavron/UpIcon/Checknox/CheckedIcon/Checknox/Unchecked Icon/Checklist Icon/Chip Icon/Clipboard / Copied Icon/Clipboard/Default Icon/Clock/Stopwatch Icon/CMD Icon/Data/Catalog Icon/Data/Engine Icon/Data/Group Icon/Data/Interact Icon/Data/Users Icon/Dive Icon/Docs/Key Icon/Dojo Icon/Email Icon/Env/Development Icon/Env/Playground Icon/Env/Prod Icon/Folder Icon/Fullscreen/Collapse Icon/Fullscreen/Expand Icon/Guides/Multiple Icon/Guides/Single Icon/Hashtag Icon/Heart/Outline Icon/Heart/Solid Icon / Cart z Icon / Click Icon / Clock Icon / Data Icon / Doc Icon / EmptyCart z Icon/Social/Facebook Icon / Genome Incognito Icon / Money Icon/Social/ProductHunt Icon / Search Icon/Social/Twitter Icon / User Icon/Info/Error Icon/Info/Info Icon/Info/Question Icon/Info/Warning Icon/Interact/Download Icon/Interact/Edit Icon/Interact/External v2 Icon/Interact/External Icon/Interact/Filter Icon/Interact/Logout Icon/Interact/Options Icon/Interact/Re-order Icon/Interact/Reload Icon/Interact/Remove Icon/Interact/Replace Icon/Interact/Search Icon/Interact/Shuffle Icon/Interact/Undo Icon/Interact/Upload Icon/Interact/Video Icon/Invoice Icon/Loading Icon/Loading Icon/Lock/Locked Icon/Lock/Unlocked Icon/Lock Icon/Mapping Menu Icon/Notification Icon/Overview Icon/Person/Team Icon/Person/User Icon/Plan/Enterprise Icon/Plan/Growth Icon/Plan/Startup Icon/Plan/Trial Icon/Recipe Icon/Rocket Icon/Settings/App Icon/Settings/User Icon/Settings Icon/Shrine Icon/Sidebar/Close Icon/Sidebar/Open Icon/Slideout Icon/Sort/Ascending Icon/Sort/Default Icon/Sort/Descending Icon/Star/Filled Icon/Star/Outlined Stopwatch Icon/Support Icon/Tag Icon/Interact/Thumb/Dislike Icon/Interact/Thumb/Like Icon/Tick Icon/Trend/New Icon/Trend/Trending Icon/Tutorial Icon/Lock/Unlocked Icon/View/Grid Icon/View/List Icon/Watchlist/Add