logo
Getting started
API Reference
ActivityTypes
Get all activity types
Activities
Add activities
Users
Get all users
Products
Get all products

v1 Reference

Welcome to the Motileo Rest API. This API provides access to our platform's core features and data. To get started, please request an API key by contacting us at hello@motileo.com or through our live chat at www.motileo.com. Our team is ready to assist you with your integration needs and answer any questions you may have.

BASE URL
https://rest.motileo.com

ActivityTypes

This section covers operations related to Activity Types within the Motileo platform. Activity Types are various tasks or actions that companies can gamify and monitor, such as 'Sales', 'Calls', and other business-related activities. These endpoints allow for the management and retrieval of these activity types, enabling companies to customize and track their unique gamification strategies.

ENDPOINTS
GET/v1/activityTypes

Activities

This section covers operations related to Activities within the Motileo platform.

ENDPOINTS
POST/v1/activities

Users

This section covers operations related to Users within the Motileo platform.

ENDPOINTS
GET/v1/users

Products

This section covers operations related to Products within the Motileo platform.

ENDPOINTS
GET/v1/products

Get all activity types

Returns all activity types.

Protected by API Key

Headers

Authorization

required, string

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

GET
/v1/activityTypes
1

Add activities

Add multiple activities into Motileo.

Protected by API Key

Headers

Authorization

required, string

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Request Body

activity_type_id

required, string

The activity type ID, retrievable from the Get activity types endpoint.

activities

required, array, maximum of 50 items, minimum of 1 items
POST
/v1/activities
1
EXAMPLE BODY
{
  "activity_type_id": "sales",
  "activities": [
    {
      "date": "2023-02-19T08:50:54.0Z",
      "user_id": 1
    },
    {
      "date": "1941-02-19T10:50:54.0Z",
      "user_id": 1,
      "product_id": 10,
      "amount": 2000,
      "description": "A brief description",
      "custom_fields": {
        "Verified": true
      }
    }
  ]
}

Get all users

Get all users available in Motileo

Protected by API Key

Headers

Authorization

required, string

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

GET
/v1/users
1

Get all products

Get all products available in Motileo

Protected by API Key

Headers

Authorization

required, string

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

GET
/v1/products
1