PostHog

Let your agents work with your PostHog analytics — run queries, manage feature flags, insights, dashboards, cohorts, surveys and experiments.

Connection

Authentication: API key (Personal API key (phx_…)).
Required settings:
- Cloud region — us for US Cloud, eu for EU Cloud

PostHog → click your avatar (top right) → Account settings → Personal API keys → Create personal API key. Pick the organization/project, grant only the scopes your agent needs (e.g. query:read, action:write, annotation:write, cohort:write, dashboard:write, insight:write, feature_flag:write, experiment:write, survey:write, person:write), then copy the key (starts with phx_) — it is shown only once.See PostHog’s documentation.

Read actions (26)

Action	Description
`get_action`	Fetch a single action by id.
`get_alert`	Fetch a single alert by id (UUID).
`get_annotation`	Fetch a single annotation by id.
`get_cohort`	Fetch a single cohort by id.
`get_dashboard`	Fetch a single dashboard (including its tiles) by id.
`get_early_access_feature`	Fetch a single early access feature by id (UUID).
`get_experiment`	Fetch a single experiment by id.
`get_feature_flag`	Fetch a single feature flag by numeric id.
`get_insight`	Fetch a single insight by numeric id.
`get_person`	Fetch a single person by numeric id.
`get_survey`	Fetch a single survey by id (UUID).
`list_actions`	List the actions (saved event definitions) of a project.
`list_alerts`	List the insight alerts of a project.
`list_annotations`	List annotations of a project, optionally filtered by a search term.
`list_cohort_persons`	List the persons belonging to a cohort.
`list_cohorts`	List the cohorts of a project.
`list_dashboards`	List the dashboards of a project.
`list_early_access_features`	List the early access features of a project.
`list_events`	Fetch recent raw events, optionally filtered by event name or person.
`list_experiments`	List the A/B test experiments of a project.
`list_feature_flags`	List the feature flags of a project.
`list_insights`	List the saved insights of a project.
`list_persons`	List persons in a project, filterable by search term, email or distinct_id.
`list_projects`	List the projects the API key can access (use this to find project_id).
`list_surveys`	List the surveys of a project.
`query`	Run a read-only HogQL (SQL) query against project analytics data.

Write actions (23)

Action	Description
`create_action`	Create an action (saved event definition) with optional match steps.
`create_alert`	Create an alert on an insight (notifies when a threshold condition is met).
`create_annotation`	Create an annotation (e.g. mark a release or campaign on graphs).
`create_cohort`	Create a cohort (dynamic via filters, or static).
`create_dashboard`	Create an empty dashboard to pin insights on.
`create_early_access_feature`	Create an early access feature users can opt into, optionally linked to a flag.
`create_experiment`	Create an A/B test experiment in draft status, backed by a feature flag key.
`create_feature_flag`	Create a feature flag with optional release conditions.
`create_insight`	Create a saved insight from a query definition (trends, funnel, HogQL…).
`create_survey`	Create a survey (created unlaunched; launch it from the PostHog UI or API).
`delete_action`	Delete an action (soft delete, as required by the API).
`delete_alert`	Permanently delete an alert by id (UUID).
`delete_annotation`	Delete an annotation (soft delete, as required by the API).
`delete_cohort`	Delete a cohort (soft delete, as required by the API).
`delete_dashboard`	Delete a dashboard (soft delete, as required by the API).
`delete_early_access_feature`	Permanently delete an early access feature by id (UUID).
`delete_experiment`	Delete an experiment (soft delete, as required by the API).
`delete_feature_flag`	Delete a feature flag (soft delete, as required by the API).
`delete_insight`	Delete an insight (soft delete, as required by the API).
`delete_person`	Delete persons by numeric id or distinct_id (optionally including their events).
`delete_survey`	Permanently delete a survey by id (UUID).
`update_feature_flag`	Update a feature flag (toggle active, change name or release conditions).
`update_person`	Update the properties of a person.

Permissions

Every action above must be explicitly granted to an agent before it can be used. See Permissions for the grant model and Security for how credentials are protected.

Using integrations

Communication

Scheduling

Project management

Docs & design

Files & storage

CRM & sales

Customer support

HR & recruiting

Commerce & billing

Developer tools

Observability & analytics

AI & media

Connection

Read actions (26)

Write actions (23)

Permissions

​Connection

​Read actions (26)

​Write actions (23)

​Permissions

Connection

Read actions (26)

Write actions (23)

Permissions