PostHog

List actions with pagination. Use offset from page_info for next page.

Get an action by ID. Use list_actions to find valid IDs.

Create a new action. Define matching criteria using steps (event name, URL, CSS selector, etc.).

Update an action’s name, description, or matching steps. Use list_actions to find valid IDs.

Soft-delete an action by marking it as deleted. Use list_actions to find valid IDs.

List activity log entries showing recent changes to the project (data management, events, properties, surveys, actions).

List annotations with pagination. Use offset from page_info for next page.

Get an annotation by ID. Use list_annotations to find valid IDs.

Create an annotation at a specific date. Useful for marking deployments, incidents, or notable events on charts.

Update an annotation’s content, date, or scope. Use list_annotations to find valid IDs.

Soft-delete an annotation by marking it as deleted. Use list_annotations to find valid IDs.

List batch export configurations with pagination. Use offset from page_info for next page.

Get a batch export configuration by ID. Use list_batch_exports to find valid IDs.

Create a batch export to regularly export data to a destination (S3, BigQuery, Snowflake, etc.).

Delete a batch export configuration permanently. Use list_batch_exports to find valid IDs.

List cohorts with pagination. Use offset from page_info for next page.

Get a cohort by ID. Use list_cohorts to find valid IDs.

Create a new cohort. Use groups to define membership criteria with property filters.

Update a cohort’s name, description, or filter groups. Use list_cohorts to find valid IDs.

Soft-delete a cohort by marking it as deleted. Use list_cohorts to find valid IDs.

List dashboards with pagination. Use offset from page_info for next page.

Get a dashboard by ID with its tiles. Use list_dashboards to find valid IDs.

Create a new dashboard. Add insights to it later using update_insight.

Update a dashboard’s name, description, or pinned status. Use list_dashboards to find valid IDs.

Soft-delete a dashboard by marking it as deleted. Use list_dashboards to find valid IDs.

List event definitions with pagination. Shows event names, volumes, and metadata tracked in the project.

Get an event definition by ID. Use list_event_definitions to find valid IDs.

Update an event definition’s description or tags. Use list_event_definitions to find valid IDs.

List experiments with pagination. Use offset from page_info for next page.

Get an experiment by ID. Use list_experiments to find valid IDs.

Create a new experiment. Requires name and feature_flag_key. The feature flag will be auto-created if it doesn’t exist.

Update an experiment’s name, description, parameters, or filters. Use list_experiments to find valid IDs.

Soft-delete an experiment by marking it as deleted. Use list_experiments to find valid IDs.

List feature flags with pagination. Use offset from page_info for next page.

Get a feature flag by ID. Use list_feature_flags to find valid IDs.

Create a new feature flag. Requires a unique key. Use filters to set release conditions.

Update a feature flag’s key, name, active status, or filters. Use list_feature_flags to find valid IDs.

Soft-delete a feature flag by marking it as deleted. Use list_feature_flags to find valid IDs.

List saved insights with pagination. Use offset from page_info for next page.

Get an insight by ID. Use list_insights to find valid IDs.

Create a new insight. Use filters for legacy insights or query for HogQL-based insights.

Update an insight’s name, description, filters, or query. Use list_insights to find valid IDs.

Soft-delete an insight by marking it as deleted. Use list_insights to find valid IDs.

List persons with pagination. Optionally search by name/distinct ID or filter by properties.

Get a person by ID with their properties and distinct IDs. Use list_persons to find valid IDs.

Delete a person and their data permanently. Use list_persons to find valid IDs.

List all projects in the organization. Use offset from page_info for next page.

Get a specific project by ID. Use list_projects to find valid project IDs.

Update a project’s name or timezone. Use list_projects to find valid project IDs.

List property definitions with pagination. Optionally filter by type (event, person, group).

Get a property definition by ID. Use list_property_definitions to find valid IDs.

Update a property definition’s description, tags, or type. Use list_property_definitions to find valid IDs.

Execute a HogQL query. Pass a query object like . Max 50k rows.

List session recordings with pagination. Use offset from page_info for next page.

Get a session recording by ID. Use list_session_recordings to find valid IDs.

Delete a session recording permanently. Use list_session_recordings to find valid IDs.

List surveys with pagination. Use offset from page_info for next page.

Get a survey by ID. Use list_surveys to find valid IDs.

Create a new survey. Define questions with type (open, multiple_choice, rating, etc.) and targeting filters.

Update a survey’s name, description, questions, or schedule. Use list_surveys to find valid IDs.

Delete a survey permanently. Use list_surveys to find valid IDs.

Get the currently authenticated user’s profile including email, name, organization, and team details.

Validate PostHog credentials by fetching the current user profile. Returns success status and authenticated user email.