Profile
Your personal Customermates settings: name, language, formats, theme and shortcuts, the channels that feed the Inbox, and your API keys.
What belongs to you rather than the workspace?
The Account part of Settings holds four pages: Profile & preferences (name, avatar, language, formats, theme, notification emails), Workspaces (the workspaces you belong to), Channels & calendars (the accounts that feed the Inbox) and API keys & connectors (keys for MCP and REST clients). Click your avatar at the bottom of the sidebar and choose Profile & preferences, or choose Settings in the workspace menu (the workspace name at the top of the sidebar) or press G then S; each opens Profile & preferences, and the settings nav lists the other pages. Back at the top of that nav returns to where you were. Changes here affect only you, except a channel you share with the workspace. Your profile is the same in every workspace you belong to, while channels and API keys belong to the workspace you connected or created them in; see Workspaces.
Every member sees Profile & preferences. Channels & calendars needs Read access All on your role's Inbox messages row and exists on Customermates Cloud only. API keys & connectors needs Read access All on API & Webhooks. A new custom role starts with None on both rows; roles are edited in Roles, see App guide, Company.
Profile & preferences
Change any field in Profile & preferences and click Save, which stores the whole form. Once something changed, a floating Unsaved changes bar offers Cancel, which discards your changes, and Save.
How do I change my name, avatar, language or theme?
| Field | Rules and effect |
|---|---|
| First Name, Last Name | Required, up to 255 characters; your name in every workspace you belong to |
| Avatar URL | Optional link to a public image (no upload; https:// is added); empty shows your initials |
| Display Language | English, German, French, Italian, Spanish, Portuguese, Polish, Dutch or System (browser language, else English). The interface and Mate use it, and so do notification emails (English with System). Saving reloads the app |
| Formatting Locale | The same choices; how numbers, dates and amounts are written, independent of the display language. System follows the display language |
| Theme | System, Dark or Light |
Theme and Language can also be switched in the personal menu. The header above the form shows your email, verification status, member status and role; these are read-only here. Role and status, and your name and avatar, can also be set by a member with Edit on Users & Roles in Members; such a change applies only in that workspace.
How do I turn off single-key shortcuts?
Switch off Single-key shortcuts in the Keyboard shortcuts dialog (press ? or choose Keyboard shortcuts in the personal menu). It disables C, /, V, ? and the G sequences, which helps with speech input or accidental key presses. Shortcuts with Cmd/Ctrl and Esc keep working. The full list is in Keyboard shortcuts.
How do I verify my email address or resend the verification email?
While your address is unverified, your avatar in the sidebar and the Profile & preferences entry in the personal menu show Email not verified; Profile & preferences then offers Resend verification email. A new account works for 24 hours without verification; after that every page leads to the verification screen until you confirm the link in the email.
What can I not change here, such as my password?
There is no setting for password, email address, time zone or deleting your account. For a new password, sign out and use Forgot password? on the sign-in page. Email signatures belong to each email channel, see email appearance and signature.
Notification emails
The Notification emails card on Profile & preferences is a table with one row per kind of notification: Due today, Replies received and Automation alerts. Each row has three choices, Email right away, Daily digest and No email, and a change saves at once. Pause emails from this workspace until holds every notification email of this workspace until the day you pick. The pause applies on every device, your choices above stay as they are, and emails resume when that day begins in your time zone. The choices and the pause belong to this workspace; other workspaces you are a member of keep their own. Every notification email ends with why you got it and two links, Turn off this kind and Manage notifications; see How do notifications and email preferences work?.
API keys & connectors
API keys & connectors lists only your own keys of the current workspace, and each key acts only in the workspace it was created in. Click Add (needs Create on API & Webhooks) to open Add an API key:
- Standard API key: a Name and an optional Expires in date 1 to 365 days ahead (default Never expires). The key is shown once, so copy it immediately.
- Quick connections: tiles for Claude, ChatGPT & Codex, Cursor and Gemini. Local setups (Claude Code or Desktop, Codex, Cursor, Gemini) create a key named after the client that expires after 365 days and show the setup snippet with the key filled in. The Claude account and ChatGPT app methods use the hosted connector and create no key.
A key card shows Created at, Expires at and Last used; open it to Delete the key (needs Delete), which stops it at once. To rotate, create a new key, update the client, then delete the old one. Removing Read access All on API & Webhooks from a role stops its members' keys for MCP and REST alike; setting a member Inactive in Members stops every key too. Full rules: API keys.
Channels & calendars
Connecting a channel here, for example WhatsApp, brings its conversations into the Inbox.
Channels & calendars lists your email, LinkedIn, WhatsApp, Instagram, Telegram and Messenger accounts first, then every channel a teammate shared. When channels show Reconnect needed, Permission issue or Error, the Channels & calendars entry shows their count. Clicking a card opens the channel dialog with the tabs Details (provider, status, Visibility, owner, folders, connected and last synced), Email and Folders. Whatever your role, you can change only channels you own. Each channel belongs to the workspace you connected it in.
Who can use Channels & calendars?
Seeing the page needs Read access All on Inbox messages; connecting needs Create, changing, reactivating or resyncing Edit, disconnecting Delete. The plan must include messaging (Pro, Business, Max, Enterprise or a trial); on Starter the page shows Upgrade your plan, which opens Billing. Every action except disconnecting also needs an active subscription or a running trial. Self-hosted installs have no Channels & calendars page.
How do I connect a channel?
Click Connect channel and pick an entry:
| Entry | Connects |
|---|---|
| Gmail, Outlook | Email, calendar or both; the card's Provider shows which |
| IMAP | Any other email account over IMAP and SMTP |
| Your WhatsApp account, by QR code | |
| LinkedIn (Classic), LinkedIn (Classic & Sales Navigator), LinkedIn (Classic & Recruiter) | Your LinkedIn account, optionally with Sales Navigator or Recruiter |
| Instagram, Telegram | Your Instagram or Telegram account |
| Messenger | Your Facebook Messenger account, with the inboxes of the Facebook Pages you administer |
The current tab goes to a secure connection page (30 minutes to finish) and then back to Channels & calendars with the result. Channel connected starts the history import in the background (Syncing in background, usually minutes, up to an hour for large accounts). Account already connected means a workspace member already connected it; ask them to share it. On any other error, start again from Connect channel.
How many channels can I connect?
Per member: Starter 0, Pro 1, Business 3, Max 10, Enterprise unlimited; a trial counts as Pro. Every channel you own counts until you disconnect it, except Deleted ones; teammates' shared channels never count. At the limit on Pro, Connect channel offers View plans, which opens Billing. After a downgrade, each member's newest channels above the allowance become Deleted and members with the Admin role get an email.
What does each channel status mean?
| Status | Meaning and action |
|---|---|
| Connected | Works; Resync re-imports the history |
| Connecting | Still being set up; Resync is available |
| Reconnect needed, Permission issue, Error, Stopped | The provider reports a login, permission or other problem, or paused the account; the owner clicks Reactivate |
| Deleted | Removed at the provider or automatically (after a downgrade, a day after a trial ended, three days after a paid subscription became Unpaid or Expired, or when the owner was set Inactive); only Disconnect remains |
How do I share a channel with teammates or keep it private?
A new channel, such as an email inbox, is Private. The owner switches Visibility on the Details tab to Shared; it then shows, with all conversations, to every member with read access on Inbox messages, and members with Create can reply from it. Sharing needs the Business, Max or Enterprise plan, Edit on Inbox messages and an active subscription. Teammates can open a shared channel's details and folders but not change it. If the workspace moves to a plan below Business, every shared channel becomes Private again, and its owner has to switch Visibility back to Shared after an upgrade. Single conversations can be shared from the Inbox.
What does the Folders tab control?
For email accounts that report folders, the Folders tab has one switch per folder: off hides that folder's messages in the Inbox for everyone who sees the channel, without deleting them. By default all folders are on except trash, junk or spam, drafts and all mail. Switching one of those on imports its history. Only the owner with Edit can switch; others see Synced or Hidden.
How do I change the font, link colour and signature of outgoing emails?
The Email tab appears on Gmail, Outlook and IMAP accounts you own (editing needs Edit) and is stored with Save email settings.
| Field | Options (default) |
|---|---|
| Font family | Sans serif (Arial), Serif (Georgia), Monospace (Courier New) (Sans serif) |
| Font size | 10 to 20 (13) |
| Link colour | Hex value with colour picker (#7161e8); a warning shows below 3:1 contrast |
| Link style | Underlined, No underline (Underlined) |
Appearance applies to plain text and Markdown emails, which includes everything written in the Inbox; an explicit HTML body keeps its styling. Switch on Add a signature to edit it: Layout Text only, Logo above (default) or Logo beside; logo layouts need a public HTTPS Logo URL (replace the Customermates icon) and offer Logo size, Divider and Spacing. Signature content is Markdown up to 2,000 characters, with a Preview. While on, the signature is added below every email from that account, from the Inbox, REST or MCP, HTML included.
How do I reactivate, resync or disconnect a channel?
Open a channel you own:
- Reactivate (for Reconnect needed, Permission issue, Error, Stopped): goes to the connection page for the same account and back.
- Resync (for Connected, Connecting): re-imports the history, usually in 1 to 3 minutes.
- Disconnect: after confirmation, removes the account and permanently deletes the conversations, messages, calendars and events imported from it, for teammates too if it was shared.
Reactivate and Resync need Edit on Inbox messages, Disconnect needs Delete.
For agents
Over MCP and in Mate, update_my_profile changes only your own first name, last name, avatar URL, theme, display language and formatting locale; connect_messaging_account (REST POST /api/v1/messaging/connected-accounts/connect-link) creates a connection link under the same plan, permission and allowance rules. manage_connected_accounts lists your channels and, for a channel you own, sets folders, signature and appearance, visibility (with approval), resyncs or disconnects it (with approval); REST uses /api/v1/messaging/connected-accounts/{id} (DELETE) and its folders, signature, sharing and resync operations. An id that is not a channel you own answers not_found (REST 404) before any plan check. Shortcuts, reactivate and API keys are set in the app only. Do not repeat a channel's signature in a message body. A new API key is shown once. Over REST, GET /api/v1/users/me reads your profile and PATCH /api/v1/users/me changes the same fields as update_my_profile; omitted fields keep their values.
Related
- API keys: creating, using, expiring and deleting keys.
- App guide, Inbox: the screen your channels feed.
- App guide, Company: members, roles and billing.
- Workspaces: what is the same in every workspace and what is separate.
- CLI and editors: where a generated key goes for Claude Code, Codex and Cursor.