Your organization is the top-level entity in MentionLab. It groups your projects, team members, billing, and API keys.
Organization settings
Access organization settings by clicking your organization name in the sidebar and selecting Settings.
General
Edit your organization’s name from the General tab.
User management
Organization roles
Navigate to Organization Settings → Users to manage your team. Each member has one of three roles:
| Role | Permissions |
|---|
| Administrator | Full access to all settings, billing, users, and projects |
| Editor | Can create and modify projects, queries, and configurations |
| Viewer | Read-only access to dashboards and analysis results |
Inviting users
Click Invite User and enter their email address. They’ll receive an invitation to join your organization. When they accept, they’ll appear in your user list and you can assign their role.
Use the Viewer role for stakeholders who only need to read reports. This prevents accidental changes to your monitoring configuration.
Project members
Each project can also have its own members with project-specific roles:
| Role | Permissions |
|---|
| Manager | Full control over the project’s settings, queries, and analysis |
| Editor | Can modify queries, tags, and competitors |
| Viewer | Read-only access to the project’s analysis |
Organization administrators automatically have access to all projects. Project-level roles are for granting access to specific users for specific projects.
Billing & Credits
MentionLab uses a credit-based billing model. Credits are consumed each time your queries are executed against AI platforms.
Viewing credit usage
Navigate to Organization Settings → Billing to see:
- Credit usage chart — A visual breakdown of credit consumption over the last 30 days
- Transaction history — A detailed log of every credit event (deductions, refunds, allocations)
Each transaction shows:
| Field | Description |
|---|
| Date | When the transaction occurred |
| Type | Deduct, refund, or allocation |
| Amount | Credits consumed or added |
| Reason | What triggered the transaction |
| Project | Which project the credits were used for |
Use the project filter to see credit usage for a specific project. This helps identify which projects consume the most resources.
Managing credit costs
Your credit consumption depends on several factors:
Credits per execution=Queries×AI Models×Iterations
API Keys
API keys let you access MentionLab’s REST API programmatically. Manage them from Organization Settings → API Keys.
Creating an API key
Click Create API Key and configure:
| Setting | Description |
|---|
| Name | A descriptive name for the key (e.g., “BI Dashboard Integration”) |
| Role | Read-only (data access only) or Read/Write (full access) |
| Expiration | Optional expiration date for the key |
Your API key is shown only once at creation. Copy and store it securely — you won’t be able to see the full key again.
Using API keys
Include your API key in the Authorization header of your requests. See the REST API documentation for detailed usage examples. 
