diff --git a/contents/docs/alerts/index.mdx b/contents/docs/alerts/index.mdx
index b38b50ac96b7..b8f5280455bf 100644
--- a/contents/docs/alerts/index.mdx
+++ b/contents/docs/alerts/index.mdx
@@ -100,6 +100,26 @@ To view all the alerts set, click [Product analytics](https://app.posthog.com/in
 />
 
 
+## Create alerts with PostHog AI
+
+You can also create and manage alerts using [PostHog AI](/docs/posthog-ai/overview) with natural language commands. Open [PostHog AI](https://app.posthog.com/#panel=max) from anywhere in the app and describe the alert you want.
+
+**Example commands:**
+
+- "Alert me when daily signups drop below 100"
+- "Create an alert when pageviews increase by more than 50%"
+- "Notify me if revenue drops more than 20% week over week"
+- "Change my alert threshold to 200"
+- "Disable the signups alert"
+
+PostHog AI can create alerts on existing insights or generate new trend insights and set up alerts on them automatically. To update existing alerts, PostHog AI finds the alert by name and applies your changes.
+
+<CalloutBox icon="IconInfo" title="Note" type="fyi">
+
+PostHog AI can only create alerts on [trends](/docs/product-analytics/trends). Other insight types like funnels and retention don't support alerts.
+
+</CalloutBox>
+
 ## Relative alerts
 Relative alerts check for change in the value of an insight.
 For example, if a value increases by 5% in a week.
diff --git a/contents/docs/posthog-ai/modes.mdx b/contents/docs/posthog-ai/modes.mdx
index 07edda369cb6..e44aebe4e4ff 100644
--- a/contents/docs/posthog-ai/modes.mdx
+++ b/contents/docs/posthog-ai/modes.mdx
@@ -41,6 +41,7 @@ The default mode for creating insights and dashboards.
 **Mode-specific tools:**
 - `create_insight` - Create or edit insights
 - `create_dashboard` / `upsert_dashboard` - Create and manage dashboards
+- `upsert_alert` - Create and edit [alerts](/docs/alerts) on trend insights
 
 ### SQL
 
diff --git a/contents/docs/posthog-ai/overview.mdx b/contents/docs/posthog-ai/overview.mdx
index 51eec650ce03..0eeb36338dae 100644
--- a/contents/docs/posthog-ai/overview.mdx
+++ b/contents/docs/posthog-ai/overview.mdx
@@ -46,6 +46,7 @@ Unlike other agents, PostHog AI can:
 - Generate complex [HogQL](/docs/sql) (our version of SQL) queries.
 - Answer questions from PostHog's documentation.
 - Create [surveys](/docs/surveys/creating-surveys) using natural language.
+- Create [alerts](/docs/alerts) to monitor insight metrics and get notified when thresholds are breached.
 - Write [Hog](/docs/hog) functions to power your realtime destinations.