From 415ee23a5882725043ae7bb71b2a37b6ec8cdc9d Mon Sep 17 00:00:00 2001
From: "inkeep[bot]" <257615677+inkeep[bot]@users.noreply.github.com>
Date: Fri, 27 Feb 2026 09:43:05 +0000
Subject: [PATCH 1/3] docs(alerts): add PostHog AI section for creating and
 managing alerts

Reflects the new UpsertAlertTool added to the PostHog AI product analytics toolkit in PostHog/posthog#48419.
---
 contents/docs/alerts/index.mdx | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

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.

From b5504490c7bbe0f75044ce453656892f372d4c2a Mon Sep 17 00:00:00 2001
From: "inkeep[bot]" <257615677+inkeep[bot]@users.noreply.github.com>
Date: Fri, 27 Feb 2026 09:43:22 +0000
Subject: [PATCH 2/3] docs(posthog-ai): add upsert_alert to Product analytics
 mode tools

Reflects the new UpsertAlertTool added to the product analytics toolkit in PostHog/posthog#48419.
---
 contents/docs/posthog-ai/modes.mdx | 1 +
 1 file changed, 1 insertion(+)

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
 

From f47b60b3e9cb1e71846012fc97c99f505fa5910b Mon Sep 17 00:00:00 2001
From: "inkeep[bot]" <257615677+inkeep[bot]@users.noreply.github.com>
Date: Fri, 27 Feb 2026 09:43:38 +0000
Subject: [PATCH 3/3] docs(posthog-ai): add alerts to PostHog AI capabilities
 list

Reflects the new UpsertAlertTool added in PostHog/posthog#48419.
---
 contents/docs/posthog-ai/overview.mdx | 1 +
 1 file changed, 1 insertion(+)

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.