Saaszly Help Center

Clear explanations for the features users ask about most: Gmail sync, AI detection, review, merge, cancellation help, alerts, organizations, AI Access, team sync debug, budgets, and privacy controls.

Getting Started

How Saaszly turns Gmail receipts into a clean subscription workspace.

What does Saaszly do?

Saaszly helps you find, review, and manage recurring subscriptions from your Gmail billing emails. It is built for individuals first, then teams that want shared software spend visibility.

What is the best first flow for a new user?

Connect Gmail, let Saaszly scan subscription-related emails, review anything marked uncertain, then use subscriptions, alerts, cancellation help, and analytics to keep spend under control.

  1. 1Connect the Gmail account that receives your receipts.
  2. 2Open Review and confirm or correct uncertain detections.
  3. 3Open Subscriptions to merge duplicates and fix price or renewal details.
  4. 4Turn on alerts for renewals and trials you cannot afford to miss.

Why does Saaszly ask users to review some detections?

Billing emails vary a lot. Review keeps Saaszly honest when an email looks like a subscription but the amount, renewal date, plan, or cancellation link is incomplete.

Gmail Sync

What happens when a user connects Gmail, syncs again, or adds another account.

What does Sync Gmail do?

Sync Gmail scans recent billing, receipt, invoice, renewal, trial, and subscription emails. Saaszly first filters likely candidates, then uses AI extraction for the details that matter.

Why might a subscription be missed?

A missing subscription usually means the receipt went to another Gmail account, the sender used unusual wording, the email is older than the scan window, or the service only charged a card without sending a useful receipt.

What does Rescan do?

Rescan clears the saved Gmail scan checkpoints for that user and checks eligible Gmail messages again. Use it after deleting subscription data, improving detection, or adding missing feedback cases.

Why add another Gmail account?

Many people split receipts across personal, work, and old accounts. Adding another Gmail account lets Saaszly detect subscriptions that never reached the primary inbox.

Can Saaszly use Gemini, Anthropic, or another AI provider for scans?

Yes. Gmail scan AI is controlled by environment variables, so the operator can switch providers without changing code. Set SYNC_AI_PROVIDER to openai, gemini, anthropic, or openai-compatible, then set SYNC_AI_MODEL and the matching API key. For custom gateways such as Bifrost, Helicone proxy, OpenRouter, or Groq, use openai-compatible with SYNC_AI_BASE_URL and SYNC_AI_API_KEY.

Subscriptions

The active subscription list and the fields users should trust or correct.

What is a subscription record?

A subscription record is Saaszly's best current view of one recurring service: name, amount, currency, billing frequency, next payment date, plan, category, confidence, and evidence.

What should users edit manually?

Users should edit any wrong amount, currency, renewal date, plan, or category. Corrections are product feedback because they show which extraction details need to improve.

What does confidence mean?

Confidence is how strongly Saaszly believes the record is a real subscription with enough supporting evidence. Low-confidence records should be reviewed before they affect decisions.

Why do amounts show in different currencies?

Saaszly keeps each subscription in the currency it was actually billed in, so an inbox with both local and USD receipts shows separate per-currency totals instead of forcing everything into one number. Those per-currency totals are the accurate figures; analytics also shows an approximate combined estimate for a rough single-number view.

Does Saaszly keep my invoices?

When a billing email includes a PDF invoice, Saaszly extracts and stores it so you can find it on the subscription's detail page under Invoice Gallery. You can also upload an invoice yourself, and each payment in the history links back to its original Gmail message.

Review Queue

How uncertain detections become trusted records.

What is the Review page for?

Review is where Saaszly sends detections that look promising but need a human decision. Confirming, editing, or rejecting these records improves the user's workspace and creates useful feedback.

What does Confirm do?

Confirm accepts the detection as a real subscription and keeps it in the active list. It should be used when the service, billing amount, and renewal signal look right.

What does Reject do?

Reject removes a detection from the active workflow when it is not a subscription, is only a one-time purchase, or belongs to something the user does not want tracked.

Trust Center

How Saaszly explains whether subscription detection is reliable.

What is Trust Center?

Trust Center is the detection reliability page. It shows the latest Gmail scan status, the scan funnel, review health, missed or rejected detection feedback, and recent job timeline events without exposing email bodies.

How should support use the detection funnel?

Use the funnel to find where a miss happened. If emails listed is low, the Gmail query or connected account is the issue. If candidates are low, deterministic triage needs better signals. If extracted is low, the AI classifier or extractor needs benchmark cases.

  1. 1Emails listed: Gmail returned eligible messages.
  2. 2Candidates: deterministic triage found billing-like emails.
  3. 3Ready for AI: classifier decided messages should be extracted.
  4. 4Extracted: AI produced subscription records.
  5. 5Saved: Saaszly inserted or updated records.

What does the trust score mean?

The trust score is a product-health signal, not a guarantee. It goes up when recent syncs complete and detections are confirmed. It goes down when users report misses, reject detections, or leave many records in review.

What should happen after a user reports a miss?

The miss should become feedback, then a redacted benchmark case. That is how Saaszly moves from flaky detection to measured reliability instead of guessing with more AI layers.

Merge Duplicates

When two records are really the same service.

What does Merge do?

Merge combines duplicate detections for the same service into one clean subscription. The kept subscription becomes the main record, and the merged records are hidden from active lists so spend is not double-counted.

When should a user merge?

Merge when two records clearly refer to the same subscription, account, plan, or renewal. For example, a renewal reminder and a payment receipt can point to the same Google One plan.

When should a user not merge?

Do not merge separate plans, different team seats, separate currencies, or two accounts that the user wants to track independently. Keeping them separate is safer than hiding real spend.

Can a merge be explained to an end user simply?

Yes. Tell them: Merge is cleanup. It turns duplicate rows for one real subscription into one trusted row, so totals, alerts, and analytics stop counting the same spend twice.

Cancellation Help

How Saaszly helps users act before money leaves their account.

What does Cancel or Manage do?

If Saaszly finds a manage or cancellation link, the button takes the user to the service's own account page. Saaszly does not cancel inside the user's account; it gets them to the right place faster.

What is cancellation proof?

Cancellation proof is a lightweight status trail. A user can mark that they opened the provider page, requested cancellation, confirmed cancellation, or could not cancel. Confirmed cancellations are marked inactive so teams know the spend cleanup actually happened.

What if there is no cancellation link?

Saaszly can show the sender, billing context, and suggested next step. A future assistant flow can draft a cancellation email when the service only supports email-based cancellation.

Why show cancellation help instead of only reminders?

Reminders tell users that money is about to leave. Cancellation help gives them a direct action path, which is what makes the product feel useful at the moment of risk.

Alerts

Trial, renewal, and risk reminders users should care about.

What alerts should users expect?

Saaszly can alert users before trials end, paid renewals happen, and risky charges arrive. The most important alerts are the ones that prevent surprise charges.

How does reminder deduping work?

Reminder deduping prevents Saaszly from sending the same alert multiple times for the same subscription, reminder type, day window, and due date.

Which reminder windows matter most?

Seven days is useful for annual renewals, three days is ideal for trials and monthly renewals, and one day is the last practical warning before a charge.

Analytics

How users understand burn rate, renewals, and category spend.

What does Monthly Spend mean?

Monthly Spend normalizes active recurring subscriptions into an estimated monthly burn rate, so monthly and annual products can be compared in one number.

What does Spend Forecasting show?

Forecasting projects upcoming cash outflow based on known amounts, frequency, and renewal dates. It helps individuals and teams plan before large renewal months arrive.

What should users look for first?

Users should look for upcoming trials, large annual renewals, category concentration, and duplicate tools that solve the same job.

What does AI Consolidation Review do?

AI Consolidation Review analyzes org subscription metadata for redundant tools, duplicate spend signals, renewal risk, and cleanup questions. It never needs raw email bodies or member email addresses to write the review.

  1. 1It looks for exact duplicate spend, like multiple members paying for the same service.
  2. 2It looks for category overlap, like multiple cloud storage or design tools solving a similar job.
  3. 3It gives practical recommendations, risks to check, and questions to answer before cancelling or migrating anything.
  4. 4If the AI provider is not configured, Saaszly shows a deterministic fallback review so the analytics page still explains what to do next.

Organizations

Team workspaces, invites, roles, and shared visibility.

What is an organization?

An organization is a shared workspace where members can contribute subscription data and leaders can understand team software spend, renewal risk, and duplicated tools.

What does Invite member do?

Invite member sends a secure invitation to a specific email address. The sender chooses the invited user's permission role before sending the invite, and the invited user must sign in with that email before joining the workspace.

What do roles mean?

Owners control the workspace. Admins manage day-to-day settings and members. Finance / CA users manage spend, exports, invoices, and subscriptions. Developer / IT users manage AI provider keys and token usage without seeing financial dashboards. Members can contribute data and request AI tokens. Restricted contributors can connect Gmail without seeing org spend. Viewers get read-only spend visibility.

Where can a user see their current role?

The organization header shows a Your role badge next to the workspace date and trial status. That badge tells the signed-in user whether they are Owner, Admin, Finance / CA, Developer / IT, Member, Restricted, or Viewer before they start taking actions.

How does an admin change someone's permission?

Owners and Admins can open Members, use the role selector beside a non-owner member, and change that user's access level. Ownership transfer stays separate because Owner is a destructive-control role and should not be assigned through a normal dropdown.

What is the Complete Permissions Matrix?

The Complete Permissions Matrix explains which workspace roles can govern the organization, manage members, view spend, sync Gmail, and control AI Access. Use it when inviting users, changing roles, or explaining why a button is hidden.

  1. 1Workspace Governance: Delete Workspace & Transfer Ownership -> Owner only. Edit Workspace Profile & Billing Plan -> Owner and Admin. Read Security Audit Logs -> Owner, Admin, and Developer.
  2. 2Team Management: Invite, Remove, & Manage Users -> Owner and Admin. Change User Roles except Owner -> Owner and Admin.
  3. 3Subscription & Financial Data: View Org-wide Spend Dashboard -> Owner, Admin, Finance, Member, and Viewer. Manage Org Subscriptions -> Owner, Admin, Finance, and Member. Export Spend Data to CSV -> Owner, Admin, and Finance. Access & Download Invoices -> Owner, Admin, and Finance.
  4. 4Integration & Syncing: Connect Personal Gmail for Syncing -> Owner, Admin, Member, and Restricted. View Own Extracted Data Only -> Owner, Admin, Member, and Restricted.
  5. 5AI Token Governance: Add/Edit AI Provider API Keys -> Owner, Admin, and Developer. Issue, Pause, & Revoke AI Tokens -> Owner, Admin, and Developer. View Org AI Usage Ledger & Costs -> Owner, Admin, and Developer. Request New AI Tokens -> Owner, Admin, and Member.
  6. 6Owner: absolute control, including deleting the organization or transferring ownership. Admin: day-to-day manager without destructive owner-only control. Finance or CA: accounting role for spend, subscriptions, exports, and invoices.
  7. 7Developer or IT: technical role for provider keys, AI tokens, usage, and audit logs without financial dashboard access. Member: standard employee who can view tools, manage shared subscription entries, sync Gmail, and request AI tokens.
  8. 8Restricted (Contributor): privacy-first contributor who can connect Gmail and contribute detected data without seeing org spend. Viewer: read-only stakeholder for monitoring dashboards.

What is data visibility?

Data visibility is the member-level consent that allows a workspace to include that member's subscription data in team views, analytics, team sync, and debug timelines. If data visibility is off, admins should not treat that member as part of shared spend reporting.

What does the org switcher do?

The org switcher lets a signed-in user move between Personal and team workspaces without mixing the context. Personal routes show the user's own subscriptions, while org routes show shared workspace data and org-specific navigation.

What is domain verification?

Domain verification proves that an admin controls a company email domain before Saaszly allows domain-based joining. The lightweight flow sends a code to a same-domain verifier email.

What should an admin explain before inviting members?

Tell members that Saaszly tracks subscription metadata, not full email bodies, and that workspace visibility depends on their membership and data-sharing state. This keeps the product honest and easier to trust.

AI Access

Workspace AI tokens, provider keys, approvals, budgets, and usage governance.

What is AI Access?

AI Access is Saaszly's workspace control plane for company AI usage. Instead of handing every employee the raw OpenAI, Anthropic, Gemini, or custom provider key, the workspace issues Saaszly tokens with approved models, budgets, environments, and expiry dates.

How does a user request a Saaszly token?

A user submits a request with the use case, agent or app name, project, provider, model needs, environment, monthly token limit, monthly cost budget, and expiry. A manager with AI Access permission reviews the request before any token is issued.

  1. 1User opens AI Access and submits the token request.
  2. 2Owner, Admin, or Developer / IT reviews the purpose and policy.
  3. 3Approver adjusts model allowlist, token limit, cost budget, rate limits, and expiry.
  4. 4If approved, Saaszly creates a token and shows the raw token only once.

What does Connect provider do?

Connect provider stores the real provider key encrypted on the server. Users never receive that provider key. Approved Saaszly tokens are intended to call Saaszly's gateway, which validates the token, applies policy, forwards to the provider, and records usage.

How does the Saaszly AI gateway work?

Apps call Saaszly with Authorization: Bearer szly_live_..., not the raw provider key. The gateway validates the token, checks model allowlists and monthly budgets, forwards OpenAI-compatible chat completions to the configured provider route, logs usage, and updates token spend.

  1. 1Connect an active provider key in AI Access.
  2. 2Approve a token request with a provider connection, allowed models, and budgets.
  3. 3Call /api/ai-gateway/v1/chat/completions with the Saaszly token.
  4. 4Monitor organization_ai_usage_events in AI Access for tokens, cost, latency, and errors.

Can Saaszly support new AI providers?

Yes. The provider catalog is configurable, and the AI Access form also supports Other / custom provider. That means a new provider can be added through configuration or routed as an OpenAI-compatible, native, Bifrost, or custom provider without rewriting the whole dashboard.

What is safer about Saaszly tokens?

Saaszly stores only a hashed token value and displays a short prefix for identification. The raw token is not recoverable after creation. Admins can pause, resume, revoke, expire, and budget tokens without exposing the underlying provider credential.

What can admins monitor?

Admins and Developer / IT users can monitor token status, owner, provider, model policy, month-to-date tokens, cost usage, budget pressure, and recent usage events. This gives teams Helicone-style visibility while keeping Saaszly independent from any single third-party observability vendor.

Which roles can use AI Access?

Owners and Admins can manage provider keys, approve requests, issue tokens, and view usage. Developer / IT can manage AI providers and tokens without seeing financial subscription dashboards. Members can request new AI tokens. Finance, Restricted, and Viewer roles do not manage AI tokens by default.

Team Sync And Debug Center

Background team sync, job history, per-member timelines, skips, failures, and retry behavior.

What does Sync Team do?

Sync Team starts background Gmail sync jobs for eligible workspace members. It does not require the admin to keep the browser open, and it only queues members who are part of the organization, have data visibility enabled, and have a connected Gmail account.

  1. 1Admin clicks Sync Team.
  2. 2Saaszly checks eligible data-sharing members.
  3. 3A separate background job is queued for each member that can sync.
  4. 4The debug center shows progress and results for each member.

What does the debug timeline mean?

The timeline is a compact operational trace of a sync job. It helps admins explain what happened without exposing private email bodies.

  1. 1Queued means Saaszly created the sync job.
  2. 2Gmail connected means the account token worked.
  3. 3Emails listed means Gmail returned eligible messages.
  4. 4Candidates after triage means deterministic filters found likely billing emails.
  5. 5Ready for extraction means AI should parse those candidates.
  6. 6Subscriptions saved means new or updated records were written.
  7. 7Summary email sent means the user received the sync synopsis when their preferences allowed it.

When should an admin retry a member sync?

Retry is meant for a single member with a failed or cancelled sync, not the whole workspace. Use it when a member reconnected Gmail, a transient Gmail/API error passed, or a previous job was cancelled before finishing.

Why was a member skipped?

A member can be skipped when their Gmail is not connected, their email is missing, they have not shared data with the workspace, or they already have an active sync job running.

What can admins see in the debug center?

Admins can see job status, member email, progress, stage labels, saved counts, and compact event metadata. They should not see full message bodies or raw private Gmail content.

How should support explain a flaky team scan?

Start with the debug center. Check whether the job listed emails, found candidates, extracted subscriptions, wrote results, or failed earlier. That tells support whether the issue is Gmail access, scan query coverage, triage, AI extraction, write/dedupe, or notification delivery.

Budgets And Team Control

Controls that turn tracking into spend governance.

What does a budget do?

A budget sets a monthly limit for a service or category. Saaszly compares active recurring spend against that limit and highlights overruns or approaching risk.

What is duplicate spend?

Duplicate spend means multiple people or accounts appear to pay for similar tools. It is not always wrong, but it is worth reviewing because it can reveal avoidable cost.

What should teams do with a duplicate spend insight?

Teams should confirm whether the subscriptions are truly redundant, decide which account or plan should stay, then use cancellation help or member follow-up to clean it up.

What is Workspace command center?

Workspace command center is the org overview that pulls together duplicate spend, renewal decisions, budget pressure, sync gaps, and open cancellation requests so admins know what to act on first.

Privacy And Data

What Saaszly stores and what users can remove.

Does Saaszly store full email bodies?

Saaszly should store compact detection evidence, not full email bodies. Evidence is meant to explain why a subscription was detected without retaining unnecessary private content.

What happens when a user deletes subscription data?

Deleting subscription data removes visible subscription records, history, and scan checkpoints so a future sync can rediscover eligible subscriptions instead of silently skipping them.

Can users disconnect Gmail?

Yes. Disconnecting Gmail should prevent future scans for that account. Existing subscription records can remain until the user deletes the data or reconnects and syncs again.

Troubleshooting

How to explain common problems without blaming the user.

A subscription is missing. What should the user try?

For a missing subscription, first check whether the receipt went to another Gmail account. Then run Rescan, search the inbox for the service name, and add feedback if Saaszly still misses it.

The wrong price or renewal date is showing. What should the user do?

Edit the subscription directly. Wrong price or date corrections are important feedback because they reveal extractor misses that the benchmark can later cover.

Why did sync stop working?

A Gmail account can stop syncing if access was revoked, the token expired without refresh, the account was disconnected, or Google requires the user to re-authorize access.

Why is Saaszly slow during sync?

Sync can feel slow when many emails need classification and extraction. Saaszly runs the scan as a background job with live progress and resumable checkpoints, and a large inbox is processed in batches that keep running server-side even if you close the tab.