Overview

CloudFix can notify you by email (and optionally Google Chat) whenever it finds new cost-saving recommendations, so you don't have to keep checking the dashboard. Each notification you set up is called an Email Integration, and you can create as many as you need — for example, one per team, one per account, or one per finder category. This article covers where to configure them, what the frequency and digest options actually do, how filtering works, and how the optional Google Chat delivery works.

Information

Setting Up an Email Notification

1. Go to Settings > Integrations.

2. In the "Email Integrations" section, click Add Integration.

3. Fill in the form:

• Email — the address that receives the notification. This cannot be changed later; if you need to redirect a notification to a different address, delete it and create a new one.
• GChat Webhook URL (optional) — see Google Chat Integration below.
• Filters (optional) — OU, Account, Region, and Tag, to restrict which recommendations qualify.
• Notification Frequency — Real Time, Daily, Twice Weekly, or Weekly.
• Opportunities per Mail — how many recommendations to include in a single message.
• Mail Format — HTML or markdown (plain text).
• Notification Type — Individual Emails or Digest.
• Selection Mode — Categories or Individual Finders (see below).

Adding, editing, deleting, or syncing an Email Integration requires the Integrations – Write permission on your CloudFix user.

Notification Frequency

CloudFix runs a scheduled job once a day that checks every Email Integration and sends a notification if it's due. Whether a given integration is "due" depends on its frequency setting and when it last sent:

• Real Time — not on the daily schedule at all. This fires immediately whenever new recommendations are found for your account(s), independent of the once-a-day job.
• Daily — sends when more than 24 hours have passed since the last send.
• Twice Weekly — sends when more than 3 days have passed since the last send. Because the underlying check only runs once a day, this works out to roughly two notifications a week (for example, Monday and Thursday), not two on a fixed schedule.
• Weekly — sends when more than 7 days have passed since the last send. This is the default for new Email Integrations.

A brand-new Email Integration that has never sent before will go out the next time the daily job runs, regardless of frequency (except Real Time, which can fire as soon as a new recommendation is found).

NOTE: Twice Weekly is a newer option, added specifically for customers who found that Weekly wasn't frequent enough but Daily was more than they wanted. If you don't see it as an option, make sure your CloudFix UI is up to date.

You don't have to wait for the schedule — from the Email Integrations table, click the sync icon next to any integration to trigger it immediately.

Individual Emails vs. Digest

The Notification Type setting controls how matching recommendations are grouped into messages when a notification fires:

• Individual Emails (default) — recommendations are grouped by finder, and you get a separate email (and GChat card, if configured) per finder. If five different finders all have qualifying recommendations in the same run, you'll receive five messages.
• Digest — all qualifying recommendations across every matching finder are combined into a single message.

Either way, the email subject line includes the frequency, e.g. "Cloudfix recommendations for [Finder Name] – Weekly Digest" for an Individual notification, or "Cloudfix recommendations – Weekly Digest" for a Digest notification.

Choosing Which Recommendations Are Included

Selection Mode determines which recommendations are eligible for this Email Integration. Pick one of the two — they're mutually exclusive, and switching modes clears the other selection:

• Categories — match by savings category: Easy, Medium, Advanced, or Best Practice. You can select more than one.
• Individual Finders — match by specific finder(s) only, picked from a searchable, category-grouped list of the finders currently visible to your tenant.

Only recommendations that are still awaiting action (status Suggested or Pending Approval) are ever included — already-actioned recommendations don't generate notifications.

Opportunities per Mail caps how many recommendations appear in a single message: All, 1, 3, 5, 10, 20, 50, or 100 (default 20). When a cap applies, CloudFix includes the recommendations with the highest annual savings first and drops the rest — it doesn't rotate through them on subsequent sends.

Filtering by Organizational Unit, Account, Region, or Tag

Use the Filters section to further restrict which recommendations qualify for this Email Integration, independent of category/finder selection:

• OU — only recommendations under the selected organizational unit(s)
• Account — only recommendations in the selected AWS account(s)
• Region — only recommendations in the selected AWS region(s)
• Tag — only recommendations on resources with the selected tag key/value pair(s)

Leave a filter empty to not restrict on that dimension. The OU, Account, and Tag pickers narrow each other's available options as you select (e.g. picking an OU limits the Account list to accounts in that OU), and Clear Filters resets all four at once.

If you want to stop CloudFix from recommending a specific resource altogether (across every Email Integration, not just this one), tag that resource cloudfix:dontFixIt rather than trying to filter it out here.

What a Notification Contains

Each recommendation in the message includes: Category, Finder ID, Downtime (Yes/No — only Easy-category recommendations are marked No), Resource ID, Region, Account ID, Account Owner, Potential Savings (annualized), Monthly Waste, a Details link to a shared report (valid for 30 days), and a Resolve link that deep-links into your CloudFix dashboard to review and approve the recommendation.

Mail Format controls how this is rendered: HTML sends a formatted table, and markdown sends the same data as a plain-text table you can paste elsewhere.

Google Chat Integration

CloudFix can also deliver the same recommendation card to Google Chat, in two independent ways:

• Webhook URL — enter an incoming webhook URL for a Google Chat space in the GChat Webhook URL field when creating or editing the Email Integration. The URL must start with https://chat.googleapis.com, or CloudFix will reject the save. Once set, every time this Email Integration sends, the same card is also posted to that space. In the Email Integrations table, an integration with a webhook configured shows status "Email + GChat" instead of "Email Only," and its expanded row includes a link to open the space.
• Automatic direct message — independent of the webhook field, CloudFix also attempts to deliver the same card as a Google Chat direct message to the Email Integration's email address, automatically, on every send. This requires no configuration on your end, but it only succeeds if that address is a real, reachable user via Google Chat — if it isn't, this delivery attempt simply fails silently and has no effect on the email or webhook delivery, which still go out normally.

You can use either, both, or neither — the GChat Webhook URL field is entirely optional, and leaving it blank does not disable the automatic direct-message attempt.

Managing an Existing Email Notification

From the Email Integrations table (Settings > Integrations):

• Click the pencil icon to edit any setting except the email address itself.
• Click the sync icon to send it immediately, outside of the normal schedule.
• Click the trash icon to delete it.
• Expand a row to see its full configuration, including which finders or categories it matches and whether GChat is attached.

Configuring via the API

Everything above is also available through the CloudFix API under /api/v3/integrations/email:

• GET /api/v3/integrations/email — list your Email Integrations, plus the allowed values for categories, frequencies, formats, opportunities-per-email, and notification types
• POST /api/v3/integrations/email — create an Email Integration
• PUT /api/v3/integrations/email/{emailIntegrationId} — edit an Email Integration
• DELETE /api/v3/integrations/email/{emailIntegrationId} — delete an Email Integration
• POST /api/v3/integrations/email/sync — trigger an immediate send for one Email Integration (pass its id)

curl -s -X POST "https://app.cloudfix.com/api/v3/integrations/email" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"email":"finops@example.com","categories":["Easy"],"notificationFrequency":"Twice Weekly","notificationType":"digest","opportunitiesPerEmail":20,"gchatWebhookUrl":"https://chat.googleapis.com/v1/spaces/XXXX/messages?key=..."}'

See CloudFix API – Customer Guide for authentication, and CloudFix API – Endpoint Summary for the full endpoint list.

Frequently Asked Questions

Q: Can I have more than one Email Integration?
A: Yes. There's no limit — many customers set up several, each with a different email, filter, and frequency (e.g. a Real Time integration for a specific critical account, plus a Weekly digest for finance).

Q: Can I change the recipient email address on an existing integration?
A: No. The email field is locked once created. Delete the integration and create a new one with the correct address.

Q: Why did my Twice Weekly notification arrive on a different day than last time?
A: Twice Weekly is evaluated against a rolling "more than 3 days since last send" rule by a job that runs once a day, not a fixed calendar schedule, so the exact send day can drift by a day depending on when the previous notification actually went out.

Q: Does Real Time mean I get an email the instant a recommendation appears?
A: Yes — Real Time integrations are triggered as soon as new recommendations are found for your account(s), rather than waiting for the daily schedule that Daily, Twice Weekly, and Weekly use.

Q: I set a GChat Webhook URL but I'm not seeing messages in Google Chat — why?
A: Double-check the URL starts with https://chat.googleapis.com (CloudFix rejects anything else) and that the webhook is still valid in that space. Also confirm the Email Integration has actually fired — use the sync icon to send it immediately and check both the space and your email.

Q: Does CloudFix support Slack notifications?
A: Not currently. Email and Google Chat (webhook or automatic direct message) are the supported notification channels.

Q: How do I stop getting notified about a specific resource?
A: Tag the resource cloudfix:dontFixIt. This excludes it from recommendations entirely, across all Email Integrations, not just from a single notification.

Q: Why am I only getting 20 recommendations when I know there are more?
A: Check the Opportunities per Mail setting — 20 is the default cap. Set it to All to include every qualifying recommendation, or increase the cap.