Microsoft Azure Azure Action Groups
Browse all Azure APIsAgent-ready OpenAPI document · curated by JenticCloud InfrastructureNetworkingoauth27 EndpointsREST
Know of an official OpenAPI document? Contribute it →
For Agents
Create, list, and update Azure Monitor action groups so alerts can route to email, SMS, webhooks, Logic Apps, or Azure Functions. Confirms receiver subscriptions via the EnableReceiver operation.
Use for: I need to create an Azure Monitor action group that emails the on-call team, List all action groups in my subscription so I can audit alert routing, Get the action group named prod-pager and inspect its webhook receivers, Update an action group to add an SMS receiver for the platform lead
Not supported: Does not define alert rules, evaluate metrics, or send the notifications themselves - use for managing the receiver list (email, SMS, webhook, Logic App, Function) that other Azure Monitor alert APIs reference.
Jentic publishes the only available OpenAPI specification for Azure Action Groups, keeping it validated and agent-ready. Azure Action Groups lets you define a reusable set of notification and automation receivers (email, SMS, voice call, webhook, Azure Function, Logic App, ITSM, Automation Runbook) that Azure Monitor alerts trigger when conditions fire. The API exposes seven operations across the microsoft.insights/actionGroups resource type, covering create, read, update, delete, list by subscription, list by resource group, and a subscribe-receiver flow for confirming opt-in receivers. It is part of the broader Azure Monitor management surface and is intended for programmatic configuration of alert routing.
Install Jentic One Beta
Connect the Azure Action Groups to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Azure Action Groups, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fazure.com%2Fazure-action-groups" | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fazure.com%2Fazure-action-groups" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with Azure Action Groups API.
Create or update an action group with email, SMS, webhook, Logic App, Azure Function, or ITSM receivers
List every action group under a subscription or scope to a single resource group
Patch tags and receiver lists on an existing action group without recreating it
Delete an obsolete action group when the alert routing it served is retired
Confirm an opt-in receiver subscription via the EnableReceiver subscribe endpoint
Fetch a specific action group by name to read its configured receivers and short name
Use Cases
Patterns agents use Azure Action Groups API for, with concrete tasks.
★ Production On-Call Routing
Stand up a single Azure Monitor action group that routes critical production alerts to email, SMS, and a PagerDuty webhook so an on-call rotation always receives them. Updating the action group propagates instantly to every alert rule that references it, so alert fan-out is changed in one place rather than per rule.
Create an action group named prod-oncall in resource group monitoring with one email receiver, one SMS receiver, and one webhook pointing at the PagerDuty endpoint, and verify the action group GET returns all three receivers.
Audit and Cleanup of Alert Routing
List every action group in a subscription, identify ones with no attached alert rules or with disabled receivers, and delete or patch them. Useful for compliance reviews where stale notification paths are a finding.
List action groups across the subscription, filter for groups with the enabled flag set to false, and delete each one using the DELETE operation on the actionGroups resource.
Webhook Integration with External Incident Tooling
Attach webhook receivers on an action group so Azure Monitor alerts post to Opsgenie, PagerDuty, ServiceNow, or a custom ingestion endpoint. The action group is the single hand-off point between Azure Monitor and the external incident system.
Patch the action group named platform-incidents to append a new ITSM receiver pointing at the ServiceNow connector and confirm the patch returned 200.
Receiver Opt-In Confirmation
When a new SMS or email receiver is added, Azure sends a confirmation message that must be acknowledged. The EnableReceiver subscribe endpoint resends that confirmation so an agent can complete onboarding without manual intervention from the receiver.
Call the EnableReceiver subscribe endpoint for action group prod-oncall with the receiver name on-call-sms to resend the SMS confirmation message.
Agent-Driven Incident Response Setup
Through Jentic, an AI agent can search for the action group operation, load its input schema, and create or update routing during an incident response runbook without browsing Azure documentation. The agent receives scoped Azure AD credentials from Jentic so the raw service principal secret never enters the agent context.
Use Jentic to search for create azure action group, load the ActionGroups_CreateOrUpdate schema, and execute it with a payload that adds a webhook receiver to the existing prod-oncall group.
Key Endpoints
7 endpoints — jentic publishes the only available openapi specification for azure action groups, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
GET
/subscriptions/{subscriptionId}/providers/microsoft.insights/actionGroups
List action groups across a subscription
GET
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.insights/actionGroups/{actionGroupName}
Get a single action group by name
PUT
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.insights/actionGroups/{actionGroupName}
Create or update an action group with its receivers
PATCH
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.insights/actionGroups/{actionGroupName}
Patch tags or receiver lists on an existing action group
DELETE
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.insights/actionGroups/{actionGroupName}
Delete an action group
POST
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.insights/actionGroups/{actionGroupName}/subscribe
Resend a receiver opt-in confirmation
GET
/subscriptions/{subscriptionId}/providers/microsoft.insights/actionGroups
List action groups across a subscription
GET
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.insights/actionGroups/{actionGroupName}
Get a single action group by name
PUT
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.insights/actionGroups/{actionGroupName}
Create or update an action group with its receivers
PATCH
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.insights/actionGroups/{actionGroupName}
Patch tags or receiver lists on an existing action group
DELETE
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.insights/actionGroups/{actionGroupName}
Delete an action group
POST
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.insights/actionGroups/{actionGroupName}/subscribe
Resend a receiver opt-in confirmation
Why Jentic?
What agents get from Jentic-routed access to this vendor.
Setup
Wiring Azure Action Groups by hand means registering an Azure AD app, running the OAuth 2.0 token exchange for management.azure.com, and adding the Azure Resource Manager plumbing that polls long-running create-or-update calls and retries on throttling. Through Jentic you install once, import Azure Action Groups from the API Directory, store the Azure AD credential once, and your agent calls it.
Permission scoping
This API puts the subscription, resource group, and action group name in the URL path (for example /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.insights/actionGroups/{actionGroupName}), so a rule can pin your agent to one action group. You choose the operations it may call, so ones like deleting an action group or resending a receiver opt-in via the subscribe endpoint are not included unless you add them.
Credential isolation
Your Azure AD credential is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'create an Azure Monitor action group' or 'add a webhook receiver to an action group', and Jentic returns the matching ActionGroups create-or-update operation with its full receiver schema so the agent calls the right endpoint without browsing Azure docs.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using Azure Action Groups API through Jentic.
Why is there no official OpenAPI spec for Azure Action Groups?
Microsoft Azure does not publish a single consolidated OpenAPI specification for Azure Action Groups. Jentic generates and maintains this spec so that AI agents and developers can call Azure Action Groups via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.
What authentication does the Azure Action Groups API use?
The API uses Azure Active Directory OAuth 2.0 with the implicit flow defined in the spec under the azure_auth scheme, scoped to user_impersonation against https://management.azure.com. Jentic stores the service principal client secret in its encrypted vault and gives the agent a scoped token, so the raw secret never reaches the agent context.
Can I add a webhook receiver to an action group via this API?
Yes. Send a PUT or PATCH to /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.insights/actionGroups/{actionGroupName} with a webhookReceivers array element containing the name and serviceUri. The same call accepts emailReceivers, smsReceivers, azureFunctionReceivers, logicAppReceivers, automationRunbookReceivers, and itsmReceivers.
What are the rate limits for the Azure Action Groups API?
Azure Resource Manager applies the standard ARM throttling limits - roughly 12,000 read and 1,200 write operations per hour per subscription per region. Action Groups inherits those limits since it is an ARM resource provider under microsoft.insights. Specific per-second ceilings are not exposed in the spec.
How do I create an action group with a webhook through Jentic?
Run pip install jentic, search Jentic for create azure action group, load the ActionGroups_CreateOrUpdate schema, then execute with a request body that includes groupShortName and a webhookReceivers entry pointing at your incident endpoint. Jentic handles the Azure AD token exchange so you do not embed the service principal secret in agent code.
Is the Azure Action Groups API free?
Calling the API itself is free, but each notification delivered through an action group is billed per Azure Monitor pricing - SMS, voice call, ITSM, and webhook deliveries each have their own per-message rates. Email notifications and Azure Function invocations have no per-message charge from Action Groups.
Can I use the EnableReceiver endpoint to confirm an SMS receiver?
Yes. POST to /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.insights/actionGroups/{actionGroupName}/subscribe with the receiver name in the request body. Azure resends the confirmation SMS or email to that receiver so the opt-in can be completed.
Can I limit what my agent is allowed to do with the Azure Action Groups API?
Yes. Jentic One runs self-hosted, so your own rules decide which operations and credentials the agent may use. Because this API carries the subscription, resource group, and action group name in the URL path, you can pin the agent to a single action group and grant only the calls it needs, such as reading or updating receivers. Higher-impact operations like deleting an action group or resending a receiver opt-in through the subscribe endpoint stay unavailable unless you explicitly add them.
GET STARTED