Company

Workspace administration in Customermates: invite and manage members, define roles, manage the plan and billing, read the activity log and set up webhooks.

Workspace settings cover everything that affects the whole workspace rather than a single record: the team and its permissions, the plan, the activity log and outbound webhooks.

Where are the workspace settings?

Click the workspace name at the top of the sidebar to open the workspace menu and choose Settings, or press G then S. Settings opens on Profile & preferences, and the sidebar switches to the settings nav: your own pages under Account, the workspace pages under Workspace: General, Members, Roles, Billing (Cloud only), Audit log, Agents, Webhooks, Incoming webhooks and Webhook log. Back at the top of the nav returns to the page you came from.

The workspace menu lists the workspaces you belong to, to switch between them, and offers Create workspace (Workspaces). It also holds Invite members (needs Users & Roles Create), Members, Settings, Billing with the plan chip (Cloud only) and, for Customermates operators only, Operator Console.

Your role decides what you see. A page your role cannot read is missing from the nav, and opening it directly lands on the Dashboard. On a page you can read but not change, Add, Save and Delete are missing and dialogs open read-only. Role changes apply on the member's next page load or API call. The built-in Admin role sees and changes everything.

PageNeeded to open it
Members, RolesUsers & Roles read access All (Assigned shows Members with only your own row)
BillingEvery member; billing controls need Company Edit
Audit logActivity log read access All
WebhooksAPI & Webhooks read access All

On Cloud, when the Terms or the DPA change, members see Legal documents updated with Review Terms and DPA and the date by which to accept. Only a member with the Admin role can accept, by ticking the checkbox and clicking Accept and continue; everyone else sees "A company administrator must accept by" that date. If nobody accepts in time, every page opens this screen until an Admin accepts.

Members

Members lists everyone in the workspace with Name, Email, Role, Status, Updated at and Created at. Search and filter by status and dates in Filter. Inviting needs Users & Roles Create; approving and editing others needs Users & Roles Edit with read access All.

How do I invite people, and when does the invitation link expire?

Click Add on Members (or Invite members in the workspace menu). The Invite User dialog has two tabs:

  • Share link shows one Invitation link for the whole workspace with a copy button. It is valid for 7 days ("Expires on" with the date) and reused until then; the first time the dialog opens after it expired, a new link is created. Anyone with the link can register, and it cannot be revoked early.
  • Send emails takes 1 to 20 addresses, separated by a comma or Enter. Send invitations emails each address the workspace link once and confirms with "Sent 3 invitations." (with the actual count). On the Free plan the dialog shows Teams start on Starter with the price instead, because Free has room for one active person.

People who register join with status Waiting for approval and no role, and see Waiting for Approval until someone approves them. You approve them on Members; for everyone with Users & Roles Edit, the workspace menu, its Members item and Members in Settings show how many people are waiting. Registering creates no record in any list. An expired or altered link shows an error asking them to request a new one. Someone who already has a Customermates account joins through the same link while signed in and waits for approval the same way; see joining with an existing account.

How do I approve, edit, deactivate or remove a member?

In Members, click the member's row to open the User dialog: Email (read-only), First Name, Last Name and Role (required), Avatar URL (optional, a publicly accessible image) and Status.

  • Approve: choose a Role, set Status to Active and click Save. The member can sign in right away and counts as a billed seat.

  • Deactivate: set Status to Inactive. That blocks their access to this workspace (they see Your access to … is inactive with the workspace name, while their other workspaces stay reachable from the workspace menu), their API keys and MCP connections for it, removes their seat from billing, pauses their routines, and the daily job deletes their connected messaging accounts. Setting Active again reactivates them. Waiting for approval cannot be chosen; only an invitation sets it.

  • Paused (Free plan): a member the Free plan paused. You cannot set this status yourself; the member comes back when the workspace chooses a paid plan, see what happens when the trial ends.

  • Remove from workspace: click Remove from workspace at the top of the dialog, or in the row's More actions menu, and confirm. It works for Active, Inactive and Waiting for approval members; for a member waiting for approval it declines the request, and the request disappears from the list. Any other removed member shows as Left and loses access on every device: their API keys and MCP connections for this workspace are revoked, the mailboxes and LinkedIn accounts they connected here are disconnected, their routines pause, and an active member's seat is freed. They get an email that they were removed; a declined request sends none. Records they own and their history stay. A member who left cannot be reactivated; to come back, they open an invitation link and ask to join again, and someone with Users & Roles Edit approves the new request. You cannot remove yourself (leave the workspace instead), the only active account of the last Customermates platform operator, or the last active member with the Admin role: the action is then missing or disabled with the reason.

  • Your own row opens read-only: change your name in Profile & preferences and ask another member with Users & Roles Edit to change your role or status.

  • Edits you make here apply to the member in this workspace only; what members change in their own Profile & preferences applies in every workspace they belong to. Members can also leave a workspace themselves, see How do I leave a workspace?.

  • The workspace always keeps at least one Active member with the Admin role; a save that would remove the last one fails with "At least one user must be a system administrator."

Every save is recorded in Audit log.

Roles

A role is a set of permissions every member with that role gets. Roles lists them with Name, Type (System for the built-in Admin, Custom for all others) and Description. Creating needs Users & Roles Create, editing Edit, deleting Delete. Without Users & Roles Edit, the page lists only your own role, and its record access shows only the lists you can read. Every role can read the workspace, its plan and its data model, however the role was saved.

How do I create a custom role, for example to restrict a member to assigned records?

Click Add, or click a row to edit. The Role editor has three tabs; a tab with an invalid field shows a red dot:

  • General: Name (required, up to 255 characters) and Description (required, up to 500 characters).
  • Workspace: one row per workspace permission in the Resource column.
  • Record types: one row per list, under its current name. Lists in Trash do not appear. New roles start without record access; grant only the lists they need. Sub-lists such as Line items share their parent record's access and have no row of their own.

Every row has Create, Edit and Delete checkboxes (under Manage on narrow screens) and Read access: All (everything the row covers), Assigned (records assigned to the member, or their own member row or routines) or None. A cell that does not apply shows a dash. Editing or deleting a record also needs access to that record.

Workspace rowWhat it controls
API & WebhooksCreate creates API keys and webhooks and resends deliveries; Edit edits webhooks and shows their secret; Delete deletes keys and webhooks; All shows keys, webhooks and deliveries.
Users & RolesCreate invites members and creates roles (with their starting record access); Edit edits and approves members and edits roles, including record access and access presets; Delete deletes roles. All shows every member and the roles, Assigned only your own member row, None hides both pages.
CompanyEdit only: uses billing on Billing.
Data modelEdit only: configures lists, fields, relationships and calculations, without record access or role administration.
Knowledge BaseCreate, Edit (and move), Delete pages; ticking any of them forces All.
Activity logRead only: Audit log and the change history on records.
Inbox messages (Cloud)Create connects accounts and sends, drafts and starts conversations; Edit changes accounts, threads, conversation state and record links; Delete disconnects accounts and discards drafts. Also limited by the plan.
Routines and automationsCreate, Edit (and run or test now), Delete; deleting a routine or pausing someone else's also needs the Admin role. All or Assigned (own routines and automations).
Public linksCreate: publish your own dashboard and list views by public link (Dashboard).

Saving a new role, webhook or routine needs Create, an existing one Edit. Access presets are defined by members with Users & Roles Edit; a Data model manager can apply one only when creating a list, and expanding grants on existing lists needs Users & Roles Edit. Inbox messages and Routines are hidden on self-hosted installs.

What is the Admin role?

Every workspace starts with one built-in role, Admin, given to the person who created it. It passes every permission check, and its editor opens read-only with "This is a system role and cannot be edited or deleted." The workspace must keep at least one Active member with it, and only its members can delete routines or pause someone else's.

What are the rules for editing roles?

  • You cannot edit your own role: its editor shows "This role is assigned to you and cannot be edited. Ask another administrator to change it."
  • Delete appears only for a custom role no member has, inactive members included. Move everyone to another role and remove the role from access presets first.
  • Changes apply to every member with the role on their next page load or API call and are recorded in Audit log.

Billing

Billing shows the plan, status, seats and billing of a Cloud workspace; self-hosted installs have no plan, and the page redirects to the Dashboard. Customermates bills through Lemon Squeezy, which runs checkout and the customer portal. Every workspace has its own plan, subscription, invoices and hosted AI credit pool; see how each workspace is billed.

FieldWhat it shows
PlanStarter, Pro, Business, Max or Enterprise with a status chip, synced from billing
Trial endsThe end of the free trial, only while the status is Trial
Current period endsThe renewal date, or after a cancellation the date the subscription ends
Active seatsBilled seats; before the first checkout the number of Active members
File storageThe storage files in file fields use, against the workspace's limit, for example 1.2 GB of 20 GB

The Billing entry in the workspace menu shows the plan with its status, for example Pro · Trial · 3 days left (only the plan name while the status is Active), and opens Billing.

Who can manage billing?

On Billing, roles with Company Edit and the Admin role see the plan picker, Manage with Lemon Squeezy and Refresh. Everyone else sees the values read-only with a hint to ask a workspace administrator. Set the Company row in Roles. Only the admin who pays for the workspace gets the full Lemon Squeezy customer portal; see How do I cancel, change the payment method or get invoices?.

What does each subscription status mean?

The app sets Trial when a login creates its first Cloud workspace. Every additional workspace that login creates starts without a trial and shows Choose a plan for … until a plan is chosen (which workspace gets the free trial). Every other status comes from Lemon Squeezy or from Customermates support.

StatusEffect
Trial14 days with Pro features; everything works until Trial ends
ActivePaid; everything the plan includes works
Past Due, CancelledPages stay open, but the Inbox and messaging, connecting channels, shared accounts and the hosted assistant are refused, and the Mate allowance drops to 0
Unpaid, ExpiredEvery page shows Subscription Required

A trial past its end date without a checkout counts as expired. Refused channel actions show "Connecting channels requires an active subscription or a trial that hasn't expired."

Which plans are there, and what do they cost?

PlanPrice per seat and monthConnected accounts per userRoutines per userInbox and messagingShared accounts
FreeFree00NoNo
Starter€1201NoNo
Pro€2915YesNo
Business€693unlimitedYesYes
Max€14910unlimitedYesYes
EnterpriseOn requestunlimitedunlimitedYesYes

Every paid plan includes the full CRM, the activity log, the API, the MCP server and the hosted assistant. Free is per workspace and meant for trying Customermates alone: 1 active person, up to 250 records and 100 MB file storage, with the API and MCP limited to 30 requests per minute and 200 per day, and without the inbox, the hosted assistant, routines, webhooks or the n8n trigger. Starter, Pro, Business and Max are billed monthly per seat in euros; there is no other interval. Hosted AI credits per active user and month, shown as Mate usage and as a multiple of the Starter allowance: Starter 1x, Pro 3x, Business 10x, Max 20x, Enterprise as contracted, 3x during the trial. Business gives the most usage per euro. The app shows usage as a percentage of your monthly allowance; see Plans and Mate usage. File storage per active user, shared in the workspace: Starter 1 GB, Pro 5 GB, Business 20 GB, Max 50 GB, Enterprise as contracted, 5 GB during the trial. Over the limit, for example after a downgrade, new uploads are refused and no file is deleted; see How do I attach files to a record?.

How do I choose or change a plan?

Before the first checkout (in practice during the trial), the plan picker shows cards for Starter, Pro (Best for follow-up), Business (For teams) and Max with price, features, connected accounts, routines and Mate usage per user as a multiple of Starter. Each card has its own button, such as Choose Pro, which opens the Lemon Squeezy checkout for as many seats as there are Active members; the checkout link expires after 15 minutes. Billing starts at checkout, even with trial days left. After payment you return to Billing: until Lemon Squeezy confirms, for up to 15 minutes, every administrator of the workspace sees "Payment is being processed" instead of the cards, the page updates by itself, and a second checkout is refused. The I didn't finish paying link brings the cards back at once; after 15 minutes, once the checkout link has expired, they come back with "Payment not received yet? Contact support" for a day.

After the first checkout the picker does not come back: the admin who pays for the workspace changes the plan with Manage with Lemon Squeezy. Enterprise workspaces never see the picker.

How do I cancel, change the payment method or get invoices?

Click Manage with Lemon Squeezy. It appears once the workspace has a self-serve subscription (not during a trial before checkout, never on Enterprise) and opens Lemon Squeezy in the same tab. What opens depends on who pays for the workspace:

  • The admin who pays, whose Customermates email is the customer email of the workspace's Lemon Squeezy subscription, gets the full customer portal: change the plan, update the payment method, download invoices and cancel.
  • Every other member who can manage billing gets only the payment details page of this workspace's subscription, to update the card and billing details.

To cancel, change the plan or get invoices, ask the admin who pays to open it. If Lemon Squeezy has no such page for the subscription, Billing shows "The billing portal is not available for this workspace. Contact support to make changes."

Portal changes reach Customermates automatically. If Billing still shows old values, Refresh re-reads status, plan, seats and dates ("Subscription refreshed successfully"). A cancellation shows as Cancelled, with the same limits as Past Due.

How are seats counted and billed?

A seat is a member with status Active; Waiting for approval and Inactive members are not billed. Seats count per workspace: a person who is Active in several workspaces is a billed seat in each of them, and leaving a workspace removes the seat there. Checkout takes the count at that moment, and every later status change on Members sends the new count to Lemon Squeezy right away: "You pay per active user. Seat changes are prorated on your next invoice." To lower the bill, set members who no longer need access to Inactive. Enterprise seats are not synced. Members paused by the Free plan are not billed; when a paid plan brings them back, they count as seats again and the new count goes to Lemon Squeezy.

What happens when the trial ends or a payment fails?

While the status is Unpaid or Expired, every page shows Subscription Required ("Workspace access is paused"). Roles with Company Edit get the plan picker to start a new checkout (Enterprise: a manual billing note), which shows "Payment is being processed" after a checkout just as Billing does; everyone else sees "A company administrator must restore the subscription". Contact Support emails support, Retry reloads. Once the subscription is usable again, you land on Billing.

When the trial ends without checkout, or a paid plan bought after the trial expires, the workspace that had the trial moves to the Free plan instead of being paused, and nothing is deleted. Free keeps 1 active person: the member who created the workspace, otherwise the member whose email pays for it, otherwise the earliest admin. Every other active member shows Paused (Free plan) on Members and gets one email. A paused member cannot open the workspace and sees "This workspace is on Free" with the name of the person to ask, while their records and history stay and their other workspaces remain reachable. Open invitation links and join requests are cancelled, routines show Paused, Free plan, existing webhooks stop sending, and connected accounts are removed, because Free has no inbox. Existing data above a Free limit stays; only adding more is refused. On Free, Billing shows the usage against the limits (people, records, file storage and the API limits) and how many people are paused, and admins see a banner such as "2 people are paused. Choose Starter to bring them back." An admin can give the active seat to a paused admin with Hand over the active seat in that member's More actions menu, which pauses the admin who does it; to hand it to someone without the Admin role, give them the role first. As soon as the workspace chooses any paid plan, every paused member is active again, routines resume and webhooks deliver again. Members an admin set to Inactive stay inactive.

A workspace without a trial whose paid plan expired, a workspace that stays Unpaid, or an expired Enterprise workspace has all members set Inactive after 3 days, and their connected accounts are deleted. Until then only the web app is paused: API keys and MCP connections keep working and webhooks keep firing, while messaging, channels and the hosted assistant stop immediately. After the 3 days nobody in the workspace can choose a plan or reactivate members, and a payment alone reactivates no one: the page Your access to … is inactive then tells every member to contact our support team, which restores the access.

What happens to connected accounts when the plan changes?

When Lemon Squeezy reports a different plan, Customermates removes each user's newest connected accounts beyond the new allowance. Starter includes 0 per user, so every account is removed; the first checkout from the trial counts as a change from Pro. Members with the Admin role get an email listing the removed accounts; the rest stay in Channels & calendars. Routines above the allowance are kept, because the allowance applies only when a routine is created. When the new plan has no shared accounts (anything below Business), every channel shared with the workspace becomes Private again for its owner, and a later upgrade does not share it again.

How does an Enterprise workspace differ?

Enterprise is set up with Customermates and billed by invoice. Billing shows only Plan and "This workspace is on an Enterprise plan billed by invoice. Contact your account manager to make changes." Self-service checkout is refused and member status changes are not sent to billing.

Where do upgrade buttons lead?

On Starter, the Inbox and Channels & calendars show Upgrade to unlock messaging with Upgrade your plan. At the connected-account limit, Pro users see Upgrade to connect more accounts with View plans, as does the hosted assistant's usage notice. All open Billing, where only roles with Company Edit can act.

Audit log: where do I find the change history?

Audit log is the workspace's event log: who changed which record, setting or configuration, and when, newest first. Each entry shows the previous and the current value inline; the same entries appear on a record's Activities view, such as a contact's, the dashboard activity widget and in Mate. Filter by kind:

  • Record changes: creates, updates and deletes of records with field values.
  • Admin and system: members, roles, webhooks, routines, connected accounts, Knowledge Base pages, legal notices and exports. Webhook secrets and header values are redacted.
  • Configuration: lists, fields, relationships and record access by role. Only roles with Data model Edit or Users & Roles Edit see these entries.

Reading it needs Activity log read access All. Record changes follow your record access, and Knowledge Base entries need Knowledge Base read access. Click an entry for details; save views as on lists. A change made through an API key or an AI agent connected over MCP names the key or application after the person, for example "Max Bergmann via Claude Desktop". Entries are kept indefinitely, messages never appear here, and history starts at the upgrade to configurable records. Available on every plan and self-hosted.

Webhooks

Webhooks sends workspace events to your systems; payloads, signatures and retries are on Webhooks. Opening it needs API & Webhooks read access All; adding needs Create, editing Edit, deleting Delete. Available on every paid plan and self-hosted, not on Free.

Click Add, or a row to edit. The Webhook dialog has URL, Description, Events, Secret, Custom headers, Body template and Enabled. For record events you also choose the lists and filters, and Record access owner: deliveries use that member's current permissions, and only an administrator can choose someone else. Clearing Enabled pauses deliveries without deleting the webhook. Without Edit, the secret and header values show as ********. Delete asks for confirmation; past deliveries stay. Searching in Filter matches the URL.

Where do I see webhook deliveries?

Webhook log, below Webhooks and Incoming webhooks in the settings navigation, lists one row per delivery, newest first, with URL, Event, Element, Status, Status Code and Created at. Click a row for Event Details: status (Pending, Sending, Delivered or Failed), status code, response message and payload. A record event's payload is read again with your current access: values you cannot read appear as restricted, and the payload stays empty when you cannot read the record. Resend (delivered or failed deliveries, API & Webhooks Create) creates a new delivery with the webhook's current URL, secret, headers and body template. A record event is read again with the webhook owner's current access, and only that owner or an administrator can resend it; details are on Webhooks.

Where is the currency set?

There is no workspace currency: every money field carries its own. Open Data model, open the list and the money field, and pick Currency. The AI workspace setup creates money fields in the currency you choose in its questions; a money field you add yourself starts in EUR. Changing a field's currency does not convert stored amounts, and totals that mix currencies show a currency mismatch instead of a sum. Configuring fields needs Data model Edit.

How do stage probabilities and totals work?

In Data model, open your deals list, open its stage field and set Probability % on each option; the AI workspace setup fills these in from the win chance of each stage. A weighted value field multiplies the deal value by the stage probability divided by 100; zero gives zero, no probability leaves it empty. Changes show a dependency preview and recalculate affected records. For pipeline totals, add a chart widget on the Dashboard that sums the deal value or the weighted value, grouped by stage if you like. See weighted pipeline.

How do I rename a list such as Deals?

Open the list in Data model, change Name and Plural name under General and click Save. Every list can be renamed; records, links, views, widgets and API references stay connected. List names must be unique, ignoring case and accents. Deleting a list moves it to Trash, where you can Restore it for 30 days or Delete permanently.

For agents

Prefer MCP tools: manage_team invites by email or returns the invitation link (invite_link), both with approval, updates members (update_member, identify by userId or email (both must match if supplied); with approval when it changes the role or status; for Waiting for approval pass a roleId and status active) and removes them from the workspace (remove_member, by userId or email, with approval), list_users reads members, manage_roles reads and saves roles with the current revision (resources api, users, company, dataModel, wiki, activityLog, inboxMessages, routines; actions create, update, delete, readAll, readOwn), manage_webhooks manages webhooks and deliveries, get_activities with an empty scope reads the activity log, and get_record_model and configure_record_model change lists, currencies and calculations. Over REST, POST /api/v1/members/invite sends invitations (1 to 20 addresses), POST /api/v1/members/invite-link returns the invitation link and its expiry, POST /api/v1/members/update changes another member's role and status; name the member by userId or email and send the fields to change; omitted fields keep their values. POST /api/v1/members/remove removes another member from the workspace, named the same way. POST /api/v1/roles/list lists the roles with their permissions; without Users & Roles Edit it returns only your own role. Billing and API keys stay in the app by design: no tool reads or changes the plan; send the user to Billing.