# PostHog AI integration on Definable

> PostHog is an open-source product analytics platform tracking user interactions and behaviors to help teams refine features, improve funnels, and reduce churn

## What this connects

PostHog is an open-source product analytics platform tracking user interactions and behaviors to help teams refine features, improve funnels, and reduce churn

Vendor: https://posthog.com/

## Tools available

**502** tools available. First 12:

- `POSTHOG_ADD_DASHBOARD_COLLABORATORS_WITH_ACCESS_LEVEL` — Add dashboard collaborators with access level — Add collaborators to a specific project dashboard. Requires 'project_id' and 'dashboard_id'. Supports JSON, form-urlencoded, and multipart data. Returns added collaborator details. Auth: 'PersonalAPIKeyAuth'. IMPORTANT REQUIREMENTS: 1. The dashboard must have restriction_level > 21 (not on the lowest restriction level). Use POSTHOG_PARTIAL_UPDATE_OF_A_PROJECT_S_DASHBOARD to set restriction_level to 37. 2. The user being added cannot be the dashboard owner or a project admin (they already have inherent access). 3. Currently only level 37 (edit access) can be explicitly specified. 4. Use POSTHOG_LIST_ORGANIZATION_MEMBERS_WITH_PAGINATION to find valid user UUIDs.
- `POSTHOG_ADD_MEMBER_TO_ORGANIZATION_ROLE` — Add member to organization role — Add a member to an organization role by submitting their details and UUID in JSON/form, using organization and role IDs. Requires PersonalAPIKeyAuth. Success gives a 201 status.
- `POSTHOG_ADD_PERSONS_TO_STATIC_COHORT` — Add persons to static cohort — Add persons to a static cohort by their UUIDs. Use when you need to manually add specific users to a static cohort. Only works with static cohorts (is_static=true), not dynamic cohorts.
- `POSTHOG_ADD_PRODUCT_INTENT_TO_PROJECT` — Add product intent to project — Tool to add a product intent to a PostHog project. Use when you need to register a project's intention to use a specific PostHog product feature. Product intents help track which features (product analytics, feature flags, data warehouse, experiments, surveys) a project plans to use.
- `POSTHOG_ADD_PROJECT_SPECIFIC_MEMBER_ROLES` — Add project specific member roles — Add members with specific roles to a project by providing their user_uuid and level (member or admin). Requires project_id in the URL. Supports JSON, form-data, and form-urlencoded input. Returns the newly created membership data upon success. Note: This endpoint only works for projects with access control enabled (private projects). If the project does not have access control enabled, the API will return a 404 "Endpoint not found" error. Access control is an Enterprise feature that can be enabled in Project Settings > Access Control.
- `POSTHOG_ADD_SESSION_RECORDING_TO_PLAYLIST` — Add session recording to playlist — Add an existing session recording to a playlist. This endpoint associates a specific session recording with a playlist, making it part of that collection. Requires 'project_id' (project identifier), 'short_id' (playlist identifier), and 'session_recording_id' (recording identifier) in the URL. Optional body parameters can be used to update playlist properties. Works with both 'collection' and 'filters' type playlists. Returns the updated playlist details on success.
- `POSTHOG_APPEND_DESKTOP_RECORDING_SEGMENTS` — Append Desktop Recording Segments — Append transcript segments to an existing desktop recording for real-time streaming support. Use when you need to add new transcript segments to a recording in batches as they become available from transcription services like AssemblyAI. Requires desktop_recording:write scope.
- `POSTHOG_ARCHIVE_SURVEY_RESPONSE` — Archive survey response — Tool to archive a single survey response. Use when you need to hide a survey response from analytics while preserving it in the database.
- `POSTHOG_ASSIGN_FEATURE_FLAG_ROLE_BASED_ACCESS` — Assign feature flag role based access — Set up role-based access for a feature flag using `project_id` and `feature_flag_id`. Submit access info in JSON or form format, with `feature_flag:write` rights. Success returns new details with a 201 code.
- `POSTHOG_BULK_CREATE_ORGANIZATION_INVITES` — Bulk create organization invites — POST /api/organizations/{organization_id}/invites/bulk/: Bulk-create organization invites with customizable levels, sender details, and validation checks. Supports email automation and private project access settings.
- `POSTHOG_BULK_DELETE_FEATURE_FLAGS` — Bulk delete feature flags — Bulk delete feature flags by filter criteria or explicit IDs. Use when you need to delete multiple feature flags at once. Accepts either 'filters' (same filter params as list endpoint: search, active, type, etc.) or 'ids' (explicit list of flag IDs). Returns operation status and count of deleted flags. Use '@current' as project_id for the current project context.
- `POSTHOG_BULK_DELETE_PERSONS` — Create Persons Bulk Delete — Tool to bulk delete persons by PostHog person IDs or distinct IDs. Use when you need to delete multiple persons at once (up to 100 per call). Only events captured before the request will be deleted. Deletion is asynchronous and batched at 5AM UTC every Sunday.

## Auth

Auth schemes: `API_KEY`.

## How agents use PostHog

Inside a Definable workflow, PostHog is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → PostHog** — the Researcher (GPT-5.5) pulls context from PostHog (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → PostHog** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into PostHog (create record, post message, draft email).
- **Designer / Engineer → Distributor → PostHog** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via PostHog (attach file, open PR comment, post status).

The Verifier checks every PostHog call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- analytics — https://definable.ai/apps/category/analytics/

## Related

- HTML page: https://definable.ai/apps/posthog/
- Same category (analytics): https://definable.ai/apps/category/analytics/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt