Documentation

How to use TidyCRM

TidyCRM connects to your CRM, scans every sub-account for stale funnels, dead workflows, forgotten contacts and unused assets, then hands you one tidy report to clean up β€” with a full recovery net so nothing is lost by accident. This guide walks through the whole workflow, step by step.

What is TidyCRM

Agencies accumulate mess: duplicate funnels, paused workflows nobody restarted, imported contacts that were never worked, tags applied to zero records. Across dozens or hundreds of sub-accounts, it's impossible to keep clean by hand.

TidyCRM audits all of it automatically. Nine scanners comb every section of every connected sub-account, apply a "staleness" rule you control, and produce a report grouped by section. You review each finding and choose what to do β€” nothing changes in your CRM until you say so.

πŸ’‘ The safety model in one line

Clean archives an item into a 30-day recovery Trash before anything is ever permanently deleted β€” and you confirm that final step yourself.

Getting started

  1. 1

    Create your account

    Go to tidycrms.com and click Start free. Enter your name, email and a password. A personal workspace is created for you automatically.

  2. 2

    Land in your dashboard

    After sign-up you're taken to a short setup wizard, then your Overview dashboard. From here you connect a CRM and run your first audit.

πŸ”’ tidycrms.com/sign-up

Create your workspace

Name

Alex Rivera

Work email

alex@brightagency.com

Password

β€’β€’β€’β€’β€’β€’β€’β€’β€’β€’
Start free β†’

No credit card required

Create your workspace in under a minute β€” no credit card to start.

Connect your CRM

Connecting takes one click β€” no tokens to copy, nothing to paste.

  1. 1

    Open Connections and click Connect with CRM

    On the Connections page (or the Overview when nothing is connected yet), click Connect with CRM.

  2. 2

    Authorize TidyCRM for your agency

    You're sent to your CRM to approve access, then bounced straight back. Every sub-account under your agency is discovered automatically.

  3. 3

    You're done

    Your connection appears with all its sub-accounts listed and ready to audit. Access is read-and-archive only, and your credentials are encrypted at rest.

πŸ”’ tidycrms.com/app/connections

Connections

✦ Connect with CRM

Bright Agency

47 sub-accounts Β· connected

● Connected

Coastal Marketing

12 sub-accounts Β· connected

● Connected
The Connections page β€” one click to authorize your whole agency.

πŸ’‘ One install covers everything

A single agency authorization connects all of that agency's sub-accounts at once. New sub-accounts you add later are picked up automatically on the next audit.

Set what to find and fix

Before your first audit, a quick wizard asks what to look for:

  1. 1

    Choose a staleness window

    How long an item must sit untouched before it counts as stale β€” 30, 60, 90, 180 or 365 days. Contacts with no activity, workflows with no runs and forms with no submissions inside this window get flagged.

  2. 2

    Pick the sections to scan

    Turn any of the nine sections on or off. Leave them all on for a full sweep.

πŸ”’ tidycrms.com/app/settings

Staleness window

30d60d90d180d365d

Sections to scan

βœ“Funnelsβœ“Workflowsβœ“Contactsβœ“Campaignsβœ“Formsβœ“Calendarsβœ“Opportunitiesβœ“Tags
Pick a staleness window and the sections to scan.

Run an audit

Click Run audit from the Overview or Audits page. TidyCRM scans your included sub-accounts and builds the report. On large accounts it scans a set number of sub-accounts per run (default 10) and rotates through the rest across runs, so scans stay fast and never time out β€” run it again to cover the next batch.

πŸ’‘ Big agency? Start small

If you have 100+ sub-accounts, run one audit, review the results, then run again. You can raise "Sub-accounts per audit" in Settings once you see how fast your account scans.

Read the report

The report groups findings by section β€” Funnels, Workflows, Contacts, Campaigns, Forms, Calendars, Opportunities, Tags and Media. Each finding shows what it is, why it was flagged, a severity, and a badge:

  • auto TidyCRM can archive or delete it directly through the CRM API.
  • manual The CRM has no delete API for this type β€” we give you a deep link to remove it inside your CRM.
πŸ”’ tidycrms.com/app/audits/latest

Audit report

Bright Smile Dental Β· 24 findings across 6 sections

All sub-accounts β–ΎOpen β–Ύ

Funnels Β· 4

Teeth Whitening Promo (old)

Draft Β· untouched 210 days

Highauto

COPY - New Patient Special

Duplicate draft Β· 150 days

Mediumauto

Summer Bootcamp 2024

Published Β· no visits 390 days

Lowmanual
An audit report β€” findings grouped by section, each with a severity and an action.

Filter by sub-account or status, and use the bulk bar to action many findings at once.

Clean, Hold, and Keep Safe

Every finding has three choices:

  • Clean β€” agree it's junk. The item is archived (a reversible action: a contact is tagged, a calendar deactivated, an opportunity marked abandoned) and moved to Trash for 30 days before any permanent delete.
  • Hold β€” a false positive. Dismisses the finding for this audit only. No change in your CRM; it may resurface in a future audit.
  • Keep Safe β€” never flag this again. The item moves to the Vaultand is permanently excluded from future audits (undo anytime).
πŸ”’ tidycrms.com/app/audits/latest
3 findings selectedCleanHoldKeep Safe

Teeth Whitening Promo (old)

Draft Β· untouched 210 days

Highauto

Abandoned - Website Redesign

No activity 320 days

Mediumauto
Choose per finding, or select many and act in bulk.

The Vault

Everything you mark Keep Safe lives in the Vault and is never flagged by an audit again. Open the Vault to review those items. For any one you can:

  • Remove from Vault β€” let audits catch it again.
  • Clean β€” archive it now and remove it from the Vault.
πŸ”’ tidycrms.com/app/vault

πŸ›‘ Vault

Items excluded from every future audit

Legacy Referral Funnel

Funnel Β· kept safe Jun 3

RemoveClean

Annual Review Reminder

Workflow Β· kept safe May 19

RemoveClean

VIP Clients

Tag Β· kept safe Apr 28

RemoveClean
Kept-safe items β€” remove them from the Vault, or clean them on the spot.

Trash & recovery

Cleaned items rest in Trash for 30 days. Nothing is permanently deleted until you explicitly empty the Trash and type DELETE to confirm. Restore any item before then to pull it back out. Items the CRM has no delete API for stay listed with a deep link for manual removal.

πŸ”’ tidycrms.com/app/trash

β—Œ Trash

Empty trash…

Teeth Whitening Promo (old)

Archived 2 days ago Β· 28 days left

Restore

COPY - New Patient Special

Archived 5 days ago Β· 25 days left

Restore
Type DELETE to permanently remove all items. This cannot be undone.
A 30-day recovery window with a type-to-confirm permanent delete.

Settings

Under Settings β†’ Audit behavior you control how every audit runs:

  • Staleness window β€” the days-untouched threshold.
  • Schedule β€” manual, weekly or monthly automatic audits.
  • Sub-accounts per audit β€” how many sub-accounts each run scans (rotating).
  • Sections β€” which of the nine scanners run.
  • Email on complete β€” notify the team when an audit finishes.
πŸ”’ tidycrms.com/app/settings

Audit behavior

Staleness window90 days β–Ύ
ScheduleWeekly β–Ύ
Sub-accounts per audit10
Email team on complete
Tune the staleness window, schedule, sections, and batch size.

Team & roles

Invite teammates from Settings β†’ Team. Roles: Owner (billing + everything), Admin (manage connections and run cleanups) and Member(view reports). Everyone works from the same workspace and audits.

Billing & plans

Standard

$9.99/mo

One CRM account Β· up to 100 sub-accounts

Unlimited

$27/mo

Unlimited CRM accounts & sub-accounts

Manage your subscription from Settings β†’ Billing (Stripe). Cancel anytime; access continues to the end of the paid period. See our Refund Policy for details.

Support

Stuck? Submit a ticket β€” if you're signed in it's linked to your account so we have the context. We reply by email.

Troubleshooting & FAQ

A whole section says "skipped" in my report.+

That section's permission wasn't granted when you authorized TidyCRM. Reconnect from the Connections page and approve all the requested permissions, then re-run. Other sections are unaffected β€” one skipped section never blocks the rest of the scan.

My audit found 0 items across all sub-accounts.+

Either your accounts really are clean, or the connection needs re-authorizing. Open Connections, reconnect with Connect with CRM, approve access, and run again.

I have 100+ sub-accounts. Will one audit cover them all?+

Each audit scans a batch (default 10) and rotates through the rest across runs. Run it a few times, or raise "Sub-accounts per audit" in Settings.

Can I undo a cleanup?+

Yes. Cleaned items sit in Trash for 30 days β€” restore any of them. Nothing is permanently deleted until you empty the Trash and confirm.

Is my data safe?+

Tokens are encrypted at rest (AES-256-GCM) and never shown again. TidyCRM only reads and, when you approve, archives/deletes β€” it never sells or trains on your data. See our Privacy Policy.

Ready to tidy up?

Connect your CRM and run your first audit in minutes.

Start free