Setting up scheduled audit runs

HubDeck Pro supports scheduled audit runs so you don't have to remember to run the tool manually. Here's how to set it up.

Using Cron (Linux / macOS)

The simplest way to schedule HubDeck is via cron. To run a weekly audit every Monday at 8am and save the output:

0 8 * * 1 HUBSPOT_TOKEN=your-token hubdeck audit --export ~/hubdeck-reports/weekly-$(date +\%Y-\%m-\%d).csv >> ~/hubdeck-reports/audit.log 2>&1

This writes the CSV export to a dated file and logs the output. You can then build a simple process around reviewing these files weekly.

Using GitHub Actions (for teams)

For teams who want a more robust setup, HubDeck works well as a GitHub Actions workflow. Store your HUBSPOT_TOKEN as a repository secret, then set up a scheduled workflow that runs HubDeck and emails the CSV output to your team.

What's in a Scheduled Report

A scheduled run produces the same output as a manual run: the full summary table, health grade, and (on Pro) the complete CSV of affected records. If you're running it weekly, you'll be able to see how your health score changes over time — useful for tracking the progress of a cleanup project.

Coming Soon

Native scheduling with email delivery and Slack notifications is on the HubDeck roadmap. For now, the cron + export approach is the recommended path for automated recurring audits.