Account settings and profile (Sparks for Teams)
Beta: Account at https://account-preview.sparks.team, main app at https://preview.sparks.team. After beta:
account.sparks.teamandapp.sparks.team.
This page describes settings and profile features in the Account area (during beta: account-preview.sparks.team) and how they align with the main app (Sparks).
Where is the Account area?
- URL (beta): https://account-preview.sparks.team
- URL (after beta):
https://account.sparks.team - From the main app: Use the profile/account icon in the top bar to open the Account area.
New here? Step-by-step self-registration (create account and organization): Self-registration in the Account area.
Overview of sections
| Section | Description |
|---|---|
| Overview | Account info, account type, display name, email, subscription & webinar add-on, change password. |
| Profile | Display name, job title, location, organization, avatar, out of office, create organization if needed. |
| Settings | Language, time zone, date/time format, email sending, theme, privacy link, delete account. |
| AI access / MCP | API keys for external AI clients and n8n (Cursor, Claude, OpenClaw) — see below. |
| Automation | Outgoing webhooks for n8n (meeting.created, meeting.ended, registration.created) — see n8n automation. |
| Team | Members, invitations, policies, limits, AI models, compliance — see Team management. |
| Webinars | Webinars with registration, manage sign-ups and permissions. |
Overview: account & subscription
Where: Account → Overview (/account).
Account information
The overview shows account type (Free/Pro/Enterprise and role), display name, email, and organization name.
Buy and manage Pro subscription
| Step | Action |
|---|---|
| Purchase | Buy subscription ( Admin or Team Admin only, per policy) |
| Seats | Choose number of licenses — at least as many as current team members (including pending invitations) |
| Billing interval | Monthly or yearly |
| Country | Country for tax display — net/gross amounts estimated via Stripe Tax; checkout may differ |
| Checkout | Redirect to Stripe — billing address and optional VAT ID |
| Manage | Manage subscription opens Stripe Customer Portal: seats, payment methods, invoices (list/download), cancel at period end |
Members without admin rights see subscription status and can use Manage subscription (e.g. invoices) but usually cannot change booked licenses.
Notes:
- After a successful purchase you see Subscription active (Stripe).
- Cancel at period end is shown when scheduled.
- During beta, Stripe may run in sandbox/test mode — no real charges.
Webinar add-on
Town Hall and Webinar meetings require a monthly webinar add-on ( Pro plan only):
- Complete Pro subscription first.
- On the overview page, Buy webinar add-on — also via Stripe.
- After activation, formats are enabled under Team (see Team management → Meeting options).
Cancel and invoices for the add-on are handled via Manage subscription in the Stripe portal.
Profile
Where: Account → Profile.
| Feature | Description |
|---|---|
| Display name, job title, location | Edit and save personal details |
| Profile picture | Upload file, URL, or pull from Matrix / update in Matrix (main app must be connected to Matrix) |
| Organization | Display name; rename under Team (admin/team admin) |
| Create organization | If you are not in an organization yet: enter name and Create organization |
| Out of office | Message and date range; Save, Edit, or Delete out of office |
Out of office
- Where: Account → Profile.
- Optionally set message and date range; used in the app (display or future integration).
Time zone and date/time format
- Where: Account → Settings.
- Time zone, date format, time format — “(System)” follows OS defaults.
- Stored in the Account profile and used by the main app.
Email sending
Where: Account → Settings → Email sending.
How Sparks sends outbound email (e.g. calendar invites):
| Option | When to use |
|---|---|
| Send email with Microsoft 365 | Default — via Microsoft account connected in the main app |
| Own email account (SMTP) | If you do not use M365: SMTP server, port, user, password, from address |
After saving you can send a test email to your account address.
Design & appearance
Where: Account → Settings → Design.
| Setting | Options |
|---|---|
| Theme | Light, dark, system, high contrast |
| Brand color | Preset swatches — applies to Account and main app |
| API server URL | Optional alternate backend URL (developers/special installs). Empty = operator default |
AI access / MCP
Where: Account → AI access / MCP (/mcp).
Create API keys for external AI clients (e.g. Cursor, Claude Desktop, OpenClaw). This is not the in-app assistant at /assistant, but the server-side livedata MCP (/api/mcp).
| Topic | Description |
|---|---|
| Create key | Choose name and scopes; plaintext key (spk_…) is shown once only |
| Scopes (opt-in) | memory (incl. search_knowledge), calendar, tasks, contacts, matrix (chats/channels), files (room files / Sparks Cloud), activity (unread & mentions), calls (call log & meeting transcripts) |
| Write | With scopes calendar / tasks: create events and tasks (Sparks Cloud). With scope matrix: send Matrix messages (send_matrix_message). With scope files plus Microsoft link: send MS chat/channel messages. |
| Notes | Matrix access requires server MATRIX_JWT_SECRET; E2EE messages are not readable by the server/MCP — tradeoffs: E2EE decision guide |
| Revoke | Active keys can be revoked at any time |
Room files via Sparks Cloud (WebDAV / Nextcloud)
With scope files and Sparks Cloud provisioned for your account, the MCP can use files in a Matrix room’s WebDAV folder — the same backend as the app’s Files tab (Nextcloud/WebDAV under the hood), not your entire Nextcloud home.
| Capability | Description |
|---|---|
| List | List files in the room folder |
| Read | Plain text/code and Office/OpenDocument extraction (pdf, docx, xlsx, pptx, odt, ods, odp); size limits apply |
| Search | On-demand keyword search over filenames and content (with snippets); no persistent file index |
| Export | Write Word (.docx) or Excel (.xlsx) into the room folder (export_to_document) |
| Versions | List Nextcloud/Sparks Cloud versions of a room file |
Requirement: Sparks Cloud for your account (provisioning). Access is limited to each room folder. Matrix chat attachments can also be read when not E2EE-protected.
Not yet / limited on MCP: arbitrary Nextcloud home; Microsoft Teams/channel/OneDrive files (code exists; often Entra admin consent / Microsoft link required — Connect Microsoft 365 to Sparks).
Related: Data backends – Sparks Cloud, Editing files (WebDAV), In-app assistant.
Call log & transcripts (scope calls)
With scope calls, the MCP (and the in-app assistant) can use your call log:
| Capability | Description |
|---|---|
| List calls | Past calls/meetings (optional filters: Matrix room, only with transcript, date range) |
| Details | Load a single call including metadata |
| Transcript | Read stored meeting text for a call ID (when present and permitted) |
Access follows the same permissions as the in-app call log. E2EE meeting content without a server-side transcript is unavailable. Related: Call log, Assistant.
Client config examples and the endpoint are shown on the Account page. The developer docs MCP (mcp-docs in the app repo) is separate and does not expose user data.
The same spk_… keys also work for automation REST (/api/v1/automation) and n8n. Developer guide: n8n automation.
Automation (outgoing webhooks)
Where: Account → Automation (/automation).
Register HTTPS URLs (e.g. n8n Webhook triggers) for events such as meeting.created, meeting.ended, and registration.created. Optional secret for HMAC (X-Sparks-Signature). Details and REST examples: n8n automation.
Privacy and blocked contacts
- Where: Account → Settings → Privacy & blocked contacts.
- Open in app → main app Settings → Privacy (blocked contacts, read receipts).
Password and security
Sparks offers two paths depending on what you need:
Change password in Sparks
Where: Account → Overview → Change password (expandable).
- Enter current password, new password, and confirmation.
- Same rules as registration: min. 8 characters, upper/lowercase, digit.
- Click Change password.
Keycloak account console (2FA, sessions)
Where: Account → Settings → Keycloak account → Open account management.
There (identity provider, e.g. Keycloak):
- Set up two-factor authentication
- Manage active sessions
- Linked identities (if offered by your operator, e.g. LinkedIn sign-in)
Note: Not every deployment enables all IdP options. If the Keycloak link is missing, contact your administrator.
Delete account
Where: Account → Settings → bottom Delete account (danger zone).
| Action | Effect |
|---|---|
| Request deletion | Pick target date → account deleted on that date |
| Organization | As Admin or Team Admin, the organization is dissolved on the same date |
| Subscription | Existing Stripe subscription is cancelled at period end |
| Cancel scheduled deletion | Revoke a pending deletion |
At the target date: Account is deactivated (no login). Physical data deletion may follow per operator policy.
The Team page only links here — no separate deletion dialog.
Devices (microphone, speaker, camera)
- Where: Main app → Settings → Calls or pre-join screen when joining a meeting.
See also
- Self-registration in the Account area
- Team management – members, invitations, limits, compliance
- Navigation and visible services
- Webinar registration
- End-to-end encryption – organization policies (E2EE on/off, device verification)
- Main app: Settings → Activity, Settings → Privacy