fix(posthog): validate integration against live API docs, add self-hosted support + CRUD coverage

Fix missing response.ok checks across ~36 tools that silently treated
error bodies as success. Fix delete_feature_flag ignoring failure
responses, evaluate_flags targeting the undocumented /decide endpoint
without the required api_key body field, and batch_events reporting a
hardcoded events_processed count.

Add self-hosted host support (utils.ts) alongside the existing US/EU
region selector, and complete CRUD coverage with 5 new tools:
update_insight, update_cohort, update_experiment, delete_survey,
create_dashboard.

Author: waleedlatif1

apps/sim/blocks/blocks/posthog.ts

@@ -1,8 +1,10 @@
+import { getPostHogIngestBaseUrl } from '@/tools/posthog/utils'
 import type { ToolConfig } from '@/tools/types'
 
 export interface PostHogBatchEventsParams {
   projectApiKey: string
   region?: 'us' | 'eu'
+  host?: string
   batch: string
 }
 
@@ -35,6 +37,13 @@ export const batchEventsTool: ToolConfig<PostHogBatchEventsParams, PostHogBatchE
       description: 'PostHog region: us (default) or eu',
       default: 'us',
     },
+    host: {
+      type: 'string',
+      required: false,
+      visibility: 'user-only',
+      description:
+        'Self-hosted PostHog instance host (e.g., "posthog.mycompany.com"). Overrides the region setting when provided.',
+    },
     batch: {
       type: 'string',
       required: true,
@@ -46,8 +55,7 @@ export const batchEventsTool: ToolConfig<PostHogBatchEventsParams, PostHogBatchE
 
   request: {
     url: (params) => {
-      const baseUrl =
-        params.region === 'eu' ? 'https://eu.i.posthog.com' : 'https://us.i.posthog.com'
+      const baseUrl = getPostHogIngestBaseUrl(params.region, params.host)
       return `${baseUrl}/batch/`
     },
     method: 'POST',
@@ -69,14 +77,20 @@ export const batchEventsTool: ToolConfig<PostHogBatchEventsParams, PostHogBatchE
     },
   },
 
-  transformResponse: async (response: Response) => {
+  transformResponse: async (response: Response, params) => {
     if (response.ok) {
       const data = await response.json()
+      let eventsProcessed = 0
+      try {
+        eventsProcessed = params ? JSON.parse(params.batch).length : 0
+      } catch {
+        eventsProcessed = 0
+      }
       return {
         success: true,
         output: {
           status: 'Batch events captured successfully',
-          events_processed: data.status === 1 ? JSON.parse(data.batch || '[]').length : 0,
+          events_processed: data.status === 1 ? eventsProcessed : 0,
         },
       }
     }

apps/sim/tools/posthog/batch_events.ts

@@ -1,8 +1,10 @@
+import { getPostHogIngestBaseUrl } from '@/tools/posthog/utils'
 import type { ToolConfig } from '@/tools/types'
 
 export interface PostHogCaptureEventParams {
   projectApiKey: string
   region?: 'us' | 'eu'
+  host?: string
   event: string
   distinctId: string
   properties?: string
@@ -38,6 +40,13 @@ export const captureEventTool: ToolConfig<PostHogCaptureEventParams, PostHogCapt
         description: 'PostHog region: us (default) or eu',
         default: 'us',
       },
+      host: {
+        type: 'string',
+        required: false,
+        visibility: 'user-only',
+        description:
+          'Self-hosted PostHog instance host (e.g., "posthog.mycompany.com"). Overrides the region setting when provided.',
+      },
       event: {
         type: 'string',
         required: true,
@@ -69,8 +78,7 @@ export const captureEventTool: ToolConfig<PostHogCaptureEventParams, PostHogCapt
 
     request: {
       url: (params) => {
-        const baseUrl =
-          params.region === 'eu' ? 'https://eu.i.posthog.com' : 'https://us.i.posthog.com'
+        const baseUrl = getPostHogIngestBaseUrl(params.region, params.host)
         return `${baseUrl}/capture/`
       },
       method: 'POST',

apps/sim/tools/posthog/capture_event.ts

@@ -1,9 +1,11 @@
+import { getPostHogAppBaseUrl } from '@/tools/posthog/utils'
 import type { ToolConfig } from '@/tools/types'
 
 interface PostHogCreateAnnotationParams {
   apiKey: string
   projectId: string
   region: string
+  host?: string
   content: string
   date_marker: string
   scope?: string
@@ -58,6 +60,13 @@ export const createAnnotationTool: ToolConfig<
       description: 'PostHog cloud region: "us" or "eu" (default: "us")',
       default: 'us',
     },
+    host: {
+      type: 'string',
+      required: false,
+      visibility: 'user-only',
+      description:
+        'Self-hosted PostHog instance host (e.g., "posthog.mycompany.com"). Overrides the region setting when provided.',
+    },
     content: {
       type: 'string',
       required: true,
@@ -93,7 +102,7 @@ export const createAnnotationTool: ToolConfig<
 
   request: {
     url: (params) => {
-      const baseUrl = params.region === 'eu' ? 'https://eu.posthog.com' : 'https://us.posthog.com'
+      const baseUrl = getPostHogAppBaseUrl(params.region as 'us' | 'eu' | undefined, params.host)
       return `${baseUrl}/api/projects/${params.projectId}/annotations/`
     },
     method: 'POST',
@@ -124,6 +133,27 @@ export const createAnnotationTool: ToolConfig<
   },
 
   transformResponse: async (response: Response) => {
+    if (!response.ok) {
+      const error = await response.text()
+      return {
+        success: false,
+        output: {
+          id: 0,
+          content: '',
+          date_marker: '',
+          created_at: '',
+          updated_at: '',
+          created_by: null,
+          dashboard_item: null,
+          insight_short_id: null,
+          insight_name: null,
+          scope: '',
+          deleted: false,
+        },
+        error: error || 'Failed to create annotation',
+      }
+    }
+
     const data = await response.json()
 
     return {

apps/sim/tools/posthog/create_annotation.ts

@@ -1,9 +1,11 @@
+import { getPostHogAppBaseUrl } from '@/tools/posthog/utils'
 import type { ToolConfig } from '@/tools/types'
 
 interface PostHogCreateCohortParams {
   apiKey: string
   projectId: string
   region: string
+  host?: string
   name: string
   description?: string
   filters?: string
@@ -59,6 +61,13 @@ export const createCohortTool: ToolConfig<PostHogCreateCohortParams, PostHogCrea
         description: 'PostHog cloud region: "us" or "eu" (default: "us")',
         default: 'us',
       },
+      host: {
+        type: 'string',
+        required: false,
+        visibility: 'user-only',
+        description:
+          'Self-hosted PostHog instance host (e.g., "posthog.mycompany.com"). Overrides the region setting when provided.',
+      },
       name: {
         type: 'string',
         required: false,
@@ -101,7 +110,7 @@ export const createCohortTool: ToolConfig<PostHogCreateCohortParams, PostHogCrea
 
     request: {
       url: (params) => {
-        const baseUrl = params.region === 'eu' ? 'https://eu.posthog.com' : 'https://us.posthog.com'
+        const baseUrl = getPostHogAppBaseUrl(params.region as 'us' | 'eu' | undefined, params.host)
         return `${baseUrl}/api/projects/${params.projectId}/cohorts/`
       },
       method: 'POST',
@@ -151,6 +160,29 @@ export const createCohortTool: ToolConfig<PostHogCreateCohortParams, PostHogCrea
     },
 
     transformResponse: async (response: Response) => {
+      if (!response.ok) {
+        const error = await response.text()
+        return {
+          success: false,
+          output: {
+            id: 0,
+            name: '',
+            description: '',
+            groups: [],
+            deleted: false,
+            filters: {},
+            query: null,
+            created_at: '',
+            created_by: null,
+            is_calculating: false,
+            count: 0,
+            is_static: false,
+            version: 0,
+          },
+          error: error || 'Failed to create cohort',
+        }
+      }
+
       const data = await response.json()
 
       return {