The CloudRadial AutomationAI SaaS Alerts extension gives a workflow or agent read-only access to SaaS Alerts reporting: investigate security events across the SaaS applications you monitor, such as Microsoft 365 and Google Workspace, list monitored customers and their users, and pull billing and monitored-seat figures. This article covers what the extension can do, the API key it needs, and the skills that ship with it. It is for workspace users who build automations (Admin or Owner Role).
- What the Extension Covers
- Creating the API Key
- Providing the Credentials to Your Runner
- Read-Only Access
- Skills
- Tips for Working With SaaS Alerts Data
What the Extension Covers
The extension calls the SaaS Alerts Reports API and provides 11 tools across these areas:
| Area | What you can automate |
| Partner account | Read your partner (MSP) profile and the MSP user the API key belongs to, which also confirms the key works |
| Customers and users | List and read the customers (organizations) you monitor, and list the monitored users for a customer |
| Security events | List and count security events filtered by customer, user, severity, event type, and time period, and run an advanced query for aggregations or filters the simple options cannot express |
| Billing and usage | List the available billing dates and read the billing and monitored-seat summary for one of them |
Install it from Extensions like any other catalog extension. It appears in the catalog as SaaS Alerts. See Browsing and installing extensions for the general install flow.
Creating the API Key
The extension signs in to SaaS Alerts with an API key. In the SaaS Alerts console at manage.saasalerts.com, go to Settings > API and click GET APIKEY. The key is shown only once, so copy it before you leave the page.
Providing the Credentials to Your Runner
Store two secrets in your runner's Key Vault with these exact names:
| Secret | Value |
SaaSAlerts-ApiUrl |
The Reports API base URL, normally the production value https://us-central1-the-byway-248217.cloudfunctions.net/reportApi/api/v1 |
SaaSAlerts-ApiKey |
The API key you copied from the SaaS Alerts console |
Store the key exactly as SaaS Alerts issued it, with no prefix. SaaS Alerts expects the key in its own api_key header rather than as a bearer token, and the extension sends it that way for you. For how to add secrets, see Accessing and updating your runner's Key Vault.
The agent reads the credentials from the runner and never asks you for them. Once the secrets are in place, ask the AI Playground for your SaaS Alerts partner profile to confirm the connection works.
Read-Only Access
All 11 tools are read-only. The extension queries events and reporting data and never changes your SaaS Alerts configuration, so no tool asks for approval. The advanced query tools send a search to SaaS Alerts; they do not modify anything.
Skills
The extension ships three skills that guide an agent through common SaaS Alerts tasks. All of them are read-only.
| Skill | Use it to |
| Investigate SaaS Security Events | Investigate or report on events such as suspicious logins, external file sharing, policy changes, and OAuth grants for one customer or across all of them, filtered by severity, event type, or time window |
| Report on Monitored Accounts | List or report on the customers SaaS Alerts monitors, your partner profile, or the monitored users within a customer |
| Pull Usage Data | Pull billing or monitored-seat figures for a billing period |
To give an agent these skills, see Creating custom agents and using them in workflows.
Tips for Working With SaaS Alerts Data
- Refer to a customer by name and let the agent look up the customer id. Listing a customer's users requires it.
- Severity is one of low, medium, or critical
- Event types use SaaS Alerts' own names, for example
login.failure,file.sharing.external,oauth.granted.permission,security.policy.changes, anduser.promoted.to.admin. You can describe the event in plain words and let the agent pick the type. - Give a time window when you ask about events. For a large pull, ask for a count first; the agent can count matching events before it retrieves them.
- Billing details are available only for the billing dates SaaS Alerts lists. The agent looks up the available dates first rather than guessing one.
If you are still having trouble, we’re here to help! Submit a ticket here for assistance, and don’t forget to check our status page to ensure there are no outages in your area.
Comments
0 comments
Please sign in to leave a comment.