Skip to main content
Your organization is the top-level entity in MentionLab. It groups your projects, team members, billing and API keys. Reach it from Organization → Settings.

​
General

Two fields: your Organisation ID (read-only, useful when contacting support) and the organization Name. Only Administrators can save changes.

​
Users

Organization Settings → Users lists your members and any pending invitations.

​
Roles

A fifth role, Super-org admin, exists on organizations that manage linked organizations. It cannot be assigned from the app — contact support@mentionlab.io.

​
Adding a member

Click Add user, enter their email and pick the Role — the role is chosen at invite time, not after they accept. If they already have a MentionLab account they join immediately; otherwise they receive an invitation email. Pending invitations appear in their own Pending Invitations list below the member grid, where you can cancel any of them.
Use Viewer for stakeholders who only read reports. It keeps your monitoring configuration safe from accidental edits.

​
Single sign-on

SSO (SAML) is available on Enterprise agreements and is configured by MentionLab, not self-serve. Contact support@mentionlab.io to set it up.

​
Project members

Projects have their own roles, independent of organization roles: Manage them from Project settings → Members, visible to Managers and Editors only.

​
Billing

MentionLab bills in tokens. Every query execution consumes tokens: Tokens per run=Queries×AI Models×Iterations\text{Tokens per run} = \text{Queries} \times \text{AI Models} \times \text{Iterations} The billing area lives at Organization Settings → Billing and is open to Administrators and Editors.
The REST API and OpenAPI schema still call this unit credits (availableCredits, perCreditCents). Tokens and credits are the same thing.

​
Overview

Three headline tiles:
  • Available tokens — your current balance, with a note of anything expiring soon.
  • Monthly tokens — allowance remaining in this cycle, with the renewal date.
  • Account status — Active, Suspended or Frozen, plus your billing mode and next charge.
Below them: your current subscription with its cycle and per-cycle price, and shortcuts to buy tokens or change plan.

​
Choose a plan

Three self-serve tiers — Launch, Scale and Business — plus Enterprise for custom volume, SSO/SAML and a dedicated account manager. Longer billing cycles (quarterly, semi-annual, annual) unlock volume discounts. Same-cycle upgrades take effect immediately and are pro-rated. Plan or cycle changes are scheduled for the end of your current cycle.

​
Buy tokens

One-time top-up — pick an amount, see the quote, pay by card. Tokens land once payment clears. The per-token rate drops as the amount rises. Multi-month plan — commit to a total volume delivered monthly over 3, 6 or 12 months, and lock today’s rate for the term. Available on invoiced agreements; talk to us to set one up.
On self-serve billing, one-time top-ups require an active subscription.
Add your legal name, billing address and tax ID under Billing → Settings before your first purchase. Without a tax ID on file, Belgian VAT is added at checkout — EU-registered businesses should add theirs to benefit from reverse-charge.

​
Activity

Three views:
  • Balance — your token pockets, broken into the lots that make them up: source (Monthly allowance, Purchase, Top-up, Plan delivery, Granted, Refund, Adjustment), amount remaining, rate per token, purchase order and expiry.
  • Activity — a Daily token usage chart over 7, 30 or 90 days, plus a Token activity ledger of every consumption event: When, Tokens, Source, PO and Reason. Filter it by project, or by “Outside any project”.
  • Statements — period summaries of tokens received, used and refunded, as downloadable PDFs. A monthly rollup is generated automatically; click New statement to generate one for any period, optionally narrowed to a single purchase order.

​
Settings

Your bill-to address, tax IDs (EU VAT, UK VAT, CH VAT, US EIN — verified with the local authority), payment method, and your full invoice history with PDFs. Credit notes appear nested under the invoice they belong to.

​
Account status

If a payment fails, the organization is suspended — new runs stop, but tokens you already bought stay available and all your data remains accessible. Update your payment method to restore service.

​
Linked organizations

Agencies and groups can run a parent organization with child organizations underneath it. Only Super-org admins see this area.
  • Overview — every linked organization with its status, balance, pending requests and last 30 days of usage.
  • Organisations — the child organizations and when each was linked.
  • Approvals — child organizations cannot buy tokens directly. Their purchase requests land here for you to approve or reject, and are charged to the parent’s payment method.
Child organizations inherit the parent’s plan and rate, see a “Billed through parent” notice instead of a subscription block, and can cancel their own pending requests.
Linking an organization is not self-serve — contact support@mentionlab.io.

​
API keys

Organization Settings → API Keys. Administrators and Super-org admins can create and delete keys; Editors can view the list.

​
Creating a key

Click Create API Key and set:
The full key is shown once, at creation. Copy it immediately — it cannot be recovered. If you lose it, delete the key and create a new one.
Read & Write is not full access. It can read data and create or update project data, but it cannot delete projects, manage members, or touch organization settings and billing.
Keys are scoped to one organization, start with ml_live_, and are sent in the x-api-key header. See the REST API documentation. To revoke a key, delete it — there is no rotation.

​
Recurring Projects

Organization Settings → Recurring Projects is a read-only, cross-project view of every project in the organization that has a schedule, showing its recurrence, execution count, models and tokens per run.