Getting Started

What is Snuffler?

Snuffler is a monitoring and reporting platform built for automation agencies and freelancers who manage n8n workflows on behalf of clients. Instead of logging into each n8n instance separately to check for failures, you connect all your instances to Snuffler and get a single pane of glass — with smart alerting, AI-powered failure summaries, and white-label SLA reports your clients can receive directly.

• Monitor all n8n instances and their workflows from one dashboard
• Get notified instantly when a workflow fails, stalls, or misses its schedule
• Generate branded PDF or XLSX reports for each client
• Invite your team and assign role-based access

Connect your first instance

The first thing you'll do after signing up is connect an n8n instance. Snuffler communicates with your n8n instance using its REST API — it only needs read access.

1. 1Go to Instances in the sidebar and click "Add Instance".
2. 2Enter a display name (e.g. "Client A — Production") and the base URL of the n8n instance (e.g. https://n8n.yourserver.com).
3. 3Paste in your n8n API key. You can generate one in n8n under Settings → API.
4. 4Click "Test Connection" to verify Snuffler can reach the instance.
5. 5Click "Save". Snuffler will immediately sync all workflows from that instance.

Dashboard overview

The Dashboard gives you a real-time snapshot of all your n8n workflows across every connected instance.

The chart below the summary cards shows execution volume over time. Use the 7d / 30d / 90d toggle to change the range and the Bar / Line toggle to switch chart type. The workflow table below lets you sort and filter by instance, name, status, or success rate.

n8n Instances

Adding an instance

Go to Instances → Add Instance. Required fields:

Testing the connection

Click Test Connection before saving. Snuffler will attempt a lightweight API call to verify the URL and API key. Common errors:

Manual sync

Snuffler automatically polls every 5 minutes. If you just deployed new workflows and want them to appear immediately, open the instance in the Instances list and click Sync Now. This triggers an immediate discovery pass for that instance only.

Supported n8n versions

Snuffler supports n8n 0.214.0 and above (when the REST API was introduced). Self-hosted and n8n Cloud instances are both supported. Snuffler auto-detects the n8n version on first connect and adjusts its API calls accordingly.

Workflows

Workflow statuses

Each workflow has a status that reflects its most recent execution result:

Workflow detail view

Click any workflow name to open its detail page. Here you'll find:

• Current status, last run time, and 7-day success rate
• Client assignment (if this workflow is associated with a client)
• Active alert rules for this workflow
• Recent execution history (last 100 executions)
• AI failure summaries for failed executions

Execution history

The execution table on the workflow detail page shows every run Snuffler has recorded, with the time, duration, and pass/fail status. Click a row to expand the n8n execution ID, which you can use to look up the full execution log in your n8n instance directly.

AI failure summaries

When a workflow fails, Snuffler automatically uses a leading AI model (via OpenAI) to explain the failure in plain English — referencing the error message, the failing node, and execution context. The summary appears on the workflow detail page next to the failed execution.

Summaries are generated once per execution and cached — they won't re-query the AI on repeated views. If no summary appears within a minute of a failure, check that your OpenAI API key is configured.

Clients

Creating a client

Clients represent the end-customers whose workflows you manage. They let you group workflows, generate branded reports, and track SLAs per customer.

1. 1Go to Clients in the sidebar and click "Add Client".
2. 2Enter the client name (required) and an optional contact email.
3. 3Optionally upload the client's logo — this appears on reports generated for that client.
4. 4Click Save.

Assigning workflows to clients

Once you've created a client, assign their workflows on the Workflow detail page:

1. 1Open any workflow from the Workflows page.
2. 2In the sidebar panel, click the "Client" dropdown.
3. 3Select the client this workflow belongs to.
4. 4The assignment saves automatically.

Alternatively, open a Client detail page and use the "Assign Workflows" button to bulk-assign multiple workflows from any instance to that client in one step.

Adding a client logo

Client logos appear on the cover page and header of all reports generated for that client. Accepted formats: PNG, JPG, SVG. Recommended size: 400×200px or wider, with a transparent or white background. Max file size: 2 MB.

1. 1Open the client from the Clients page.
2. 2Click the logo placeholder (or the existing logo) to open the upload dialog.
3. 3Select your file and click Upload.
4. 4The logo is saved and will appear on all future reports for this client.

Client detail view

The Client detail page shows all workflows assigned to that client, their combined success rate, recent failures, and a shortcut to generate a report for that client directly.

Alerts & Notifications

Alert types

Snuffler supports three alert trigger conditions:

Alert channels

Alert channels define where notifications are sent. You can create multiple channels of different types and assign any combination of channels to each alert rule.

Email alerts

1. 1Go to Alerts → Settings and click "Add Channel".
2. 2Choose "Email" as the type.
3. 3Enter a channel name (e.g. "Team email") and one or more email addresses separated by commas.
4. 4Click "Send test" to verify a test email arrives.
5. 5Save the channel.
6. 6When creating an alert rule, select this channel in the "Notify via" field.

Slack alerts

1. 1In your Slack workspace, go to api.slack.com/apps → Create New App → From scratch.
2. 2Under "Incoming Webhooks", activate and create a new webhook for the channel you want.
3. 3Copy the Webhook URL (starts with https://hooks.slack.com/…).
4. 4In Snuffler → Alerts → Settings → Add Channel, choose "Slack" and paste the URL.
5. 5Click "Send test" — you should see a test message appear in Slack.

Webhook alerts

The generic webhook channel sends an HTTP POST to any URL with a JSON body:

{
  "workflow_name": "Invoice Sync",
  "client":        "Acme Corp",
  "status":        "failed",
  "alert_type":    "on_failure",
  "error_message": "HTTP node timed out",
  "failing_node":  "HTTP Request",
  "ai_summary":    "The HTTP node failed because…",
  "fired_at":      "2025-04-11T14:22:00Z"
}

This lets you integrate with PagerDuty, Opsgenie, Zapier, Make.com, or any custom endpoint. Set Authorization headers in the webhook URL itself if your endpoint requires auth (e.g. https://endpoint.example.com?token=secret).

Cooldowns & deduplication

To prevent alert fatigue, Snuffler enforces a 30-minute cooldown per workflow per alert type. If the same alert fires again within 30 minutes, the notification is suppressed. After 30 minutes, a fresh notification is sent.

This is automatic and cannot be configured per-rule in the current version.

Resolving alerts

Alerts appear in the Alerts page with a status of "fired". Once you've investigated and fixed the issue, mark the alert as resolved:

1. 1Open the Alerts page.
2. 2Find the alert and click the "Resolve" button (checkmark icon).
3. 3The alert moves to resolved status and is removed from the active alerts count.

Reports

Creating a report

Reports are SLA summaries you can send to clients or keep for internal records. Go to Reports → New Report.

1. 1Choose a report name (e.g. "Acme Corp — March 2025").
2. 2Select the date range to cover.
3. 3Choose the scope: a specific client, or all workflows.
4. 4Click "Generate". Snuffler will compile the data and render the report.

Report generation takes 5–20 seconds depending on the number of workflows and executions in range.

Report scope

Each report includes:

• Executive summary (total executions, success rate, top failing workflows)
• Per-workflow breakdown (success/failure counts, average duration, trend)
• Timeline of failures with error messages
• AI-generated plain-English summaries for recurring failures

White-label & logos

On Agency and Studio plans, reports use your client's logo on the cover page and headers. To add or change a client logo, see the Adding a client logo section above.

You can also set an organization logo under Settings → Branding, which appears in the footer of all reports as "Powered by [Your Agency Name]". To remove the "Powered by Snuffler" footer entirely, contact support (Studio plan feature).

Downloading (PDF / XLSX)

From any report detail page, use the download buttons in the top-right corner:

Sharing a public link

You can share a report with a client without requiring them to log in.

1. 1Open the report you want to share.
2. 2Click "Share" (link icon) in the top-right.
3. 3A unique, permanent public link is generated — copy it.
4. 4Send the link to your client. Anyone with the link can view the report (read-only).

Team

Inviting team members

1. 1Go to Team in the sidebar.
2. 2Click "Invite Member".
3. 3Enter the email address and choose a role.
4. 4Click Send Invite — the person receives an email with a sign-up link.
5. 5Once they accept, they appear in the team list with their assigned role.

Roles & permissions

Seat limits by plan

If you need more seats than your plan allows, upgrade from the Billing page.

AI Assistant

What the AI can do

The Snuffler AI Assistant (available via the chat icon in the bottom-right corner) is a context-aware assistant that knows your workflows, alert history, and execution data. You can ask it:

• Why did workflow "Invoice Sync" fail yesterday?
• Which workflows have had the most failures this month?
• What's causing the recurring error in "Send Report" workflow?
• Show me the success rate trend for Acme Corp workflows
• What workflows haven't run in the past 24 hours?

Using the assistant

Click the icon in the bottom-right corner to open the AI chat panel. Type your question in plain English — no special syntax required.

The assistant has access to your current organization's data only — it cannot see data from other Snuffler customers. Conversations are not retained between sessions.

Billing & Plans

Plan overview

14-day free trial

Every new account starts with a 14-day free trial at the Agency tier — no credit card required. You get access to all Agency features during the trial.

You'll receive reminder emails at day 10 and day 13. After 14 days, your account switches to read-only mode until you add a payment method and choose a plan. No data is deleted — you can pick up exactly where you left off.

Upgrading / downgrading

1. 1Go to Billing in the sidebar.
2. 2Choose the plan you want to switch to.
3. 3Click "Upgrade" (or "Downgrade").
4. 4You'll be taken to Stripe Checkout to enter your payment details.
5. 5After checkout, your plan is updated immediately.

Billing portal

To manage your subscription — update your card, view invoices, or cancel — click Manage Billing on the Billing page. This opens the Stripe Customer Portal in a new tab.

All invoices are available in the portal and can be downloaded as PDFs for accounting purposes.

Account Settings

Profile & password

Go to Settings to update your display name, email address, and password. If you signed up via Google or GitHub OAuth, you don't have a password set — use "Set a password" to add one (useful as a backup login method).

Organization branding

Upload your agency's logo under Settings → Organization. This logo appears in the footer of all reports generated for your clients ("Prepared by [Your Agency]").

• Accepted formats: PNG, JPG, SVG
• Recommended dimensions: 400×120px
• Max file size: 2 MB
• Transparent background recommended for clean rendering on white report pages

Deleting your account

To delete your organization, go to Settings → Danger Zone → Delete Organization. You'll be asked to type your organization name to confirm.

If you only want to remove your personal account but keep the organization running for your team, transfer ownership to another admin first, then delete your user account from the same page.