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.