User Types & Access Tokens

Understanding how users and tokens work is essential for integrating with the LogMeal API and the LogMeal Platform.
Tokens determine who is making the request and what resources they can access — both for direct API calls and when using the LogMeal Platform.

User Types

There are three types of users in the LogMeal ecosystem. Each has different responsibilities and access scopes:

Icon	User Type	Usage
⚫ APICompany	Account-level manager. Created automatically when you sign up to the API.	Responsible for creating and managing APIUsers and APIUserManagers. Only one per subscription.
🔴 APIUser	Represents an end-user of your app or service. Each final user must have their own APIUser. A user-specific language and country can be assigned during creation. APIUsers can later update these attributes via `/modifyUserProfileInfo` endpoints or directly in the LogMeal App. These fields are essential for localized nutrition analysis, ensuring that recognition, nutritional values, and recommendations align with the user’s regional context.	They can log meals, submit intakes, run food recognition, and track nutritional history. Their data also powers dashboards inside the LogMeal Platform.
🔵 APIUserManager	Supervisor users (e.g. healthcare professionals, nutritionists). Their access is available only in higher-tier plans (e.g. Monitor or higher).	They can view and manage the intakes of multiple APIUsers. Managers often work directly inside the LogMeal Platform to visualize and manage users’ nutrition data.

👉 For a quick overview, see the Plans & Limits page for which user types are supported under each plan.

Access Tokens

Each user has a unique access token — a non-transferable secret key used to authenticate API calls.

APICompany Token (⚫): Issued when you subscribe to the API. Found in the “Profile” section of the dashboard. Used to create/manage APIUsers and APIUserManagers.
APIUser Token (🔴): Issued automatically when creating an APIUser. Required for recognition endpoints (e.g. image analysis, intake submission). These users also have access to the white-labeled LogMeal App. They can also update their profile information with dedicated endpoints.
APIUserManager Token (🔵): Issued automatically when creating an APIUserManager. Grants access to dashboards and endpoints for managing user intakes and goals. APIUserManagers use this token both in the API and when signing in to the LogMeal Platform.

Best Practice: Always keep tokens secret. Treat them like passwords. Do not expose them in client-side code.

Creating Users

You can create users either through the LogMeal Users Dashboard, or via the Management API.

1. Web Dashboard

Log in with your company account at LogMeal Login Page
Go to the LogMeal Users Dashboard.
Choose whether to add a new APIUser or APIUserManager.
Fill in details (language, username, email, password if required).
After creation, the system assigns an ID and a Token.

📖 For an overview of how nutrition professionals can use these accounts, visit LogMeal NutraExpert.

2. API Management Endpoints

If you prefer automation, you can use the APICompany token (⚫) to call user management endpoints:

Create APIUser → POST /users/signUp
Create APIUserManager → POST /managers
Assign access (link APIUserManager ↔ APIUser) → POST /managers/userAccess
Modify APIUser profile → POST /users/modifyUserProfileInfo. This endpoint allows updating country and language attributes, among others.
- country ensures nutritional values and datasets are adapted to local standards.
- language personalizes the user’s experience in the LogMeal App and Platform as well as in the name of dishes, ingredients and nutritional indicators.

📖 See the External Management feature for full details.

Example Workflows

App End-User (🔴 APIUser)
- A mobile app creates an APIUser for each registered user.
- That token is then used for calls like POST /image/segmentation/complete or GET /intake/{imageId}.
- The same user can log in to the white-labeled LogMeal App to view their intake history and nutrition insights. They can also update profile preferences such as language and country, which directly influence how nutritional information and recommendations are presented.
Nutrition Platform (🔵 APIUserManager)
- A clinic creates APIUserManagers for dietitians or healthcare professionals.
- Each manager can view the intake history of multiple clients or patients (🔴 APIUsers).
- Managers typically use the LogMeal Platform as their dashboard to analyze patient data, set goals, and monitor adherence.
Company-Level Control (⚫ APICompany)
- An admin uses the APICompany token to onboard new users and assign supervisors.
- They also manage organizational settings in the LogMeal Dashboard.

Next Steps

Image Pre-processing → how to prepare images before recognition.
Plans & Limits → which users and endpoints are included in each plan.
API Documentation → exact endpoints and request/response schemas.
Learn how professionals use the LogMeal Platform in real-world nutrition workflows.