PostHog

Capture Event

Capture a single event in PostHog. Use this to track user actions, page views, or custom events.

Batch Events

Capture multiple events at once in PostHog. Use this for bulk event ingestion to improve performance.

List Persons

List persons (users) in PostHog. Returns user profiles with their properties and distinct IDs.

Get Person

Get detailed information about a specific person in PostHog by their ID or UUID.

Delete Person

Delete a person from PostHog. This will remove all associated events and data. Use with caution.

Run Query (HogQL)

Execute a HogQL query in PostHog. HogQL is PostHog's SQL-like query language for analytics. Use this for advanced data retrieval and analysis.

List Insights

List all insights in a PostHog project. Returns insight configurations and metadata.

Get Insight

Get a specific insight by ID from PostHog. Returns detailed insight configuration and metadata.

Create Insight

Create a new insight in PostHog. Requires insight name and a query configuration.

Update Insight

Update an existing insight in PostHog. Can modify name, description, query, dashboards, tags, and favorited status.

List Dashboards

List all dashboards in a PostHog project. Returns dashboard configurations, tiles, and metadata.

Get Dashboard

Get a specific dashboard by ID from PostHog. Returns detailed dashboard configuration, tiles, and metadata.

Create Dashboard

Create a new dashboard in PostHog. Optionally seed it from a built-in template, then attach insights to it afterward.

List Actions

List all actions in a PostHog project. Returns action definitions, steps, and metadata.

List Cohorts

List all cohorts in a PostHog project. Returns cohort definitions, filters, and user counts.

Get Cohort

Get a specific cohort by ID from PostHog. Returns detailed cohort definition, filters, and user count.

Create Cohort

Create a new cohort in PostHog. Requires cohort name and filter or query configuration.

Update Cohort

Update an existing cohort in PostHog. Can modify name, description, filters, query, static membership, and deleted status.

List Annotations

List all annotations in a PostHog project. Returns annotation content, timestamps, and associated insights.

Create Annotation

Create a new annotation in PostHog. Mark important events on your graphs with date and description.

List Feature Flags

List all feature flags in a PostHog project

Get Feature Flag

Get details of a specific feature flag

Create Feature Flag

Create a new feature flag in PostHog

Update Feature Flag

Update an existing feature flag in PostHog

Delete Feature Flag

Delete a feature flag from PostHog

Evaluate Flags

Evaluate feature flags for a specific user or group. This is a public endpoint that uses the project API key.

List Experiments

List all experiments in a PostHog project

Get Experiment

Get details of a specific experiment

Create Experiment

Create a new experiment in PostHog

Update Experiment

Update an existing experiment in PostHog. Use this to change dates, archive an experiment, or adjust its parameters and filters.

List Surveys

List all surveys in a PostHog project. Surveys allow you to collect feedback from users.

Get Survey

Get details of a specific survey in PostHog by ID.

Create Survey

Create a new survey in PostHog. Supports question types: Basic (open), Link, Rating, and Multiple Choice.

Update Survey

Update an existing survey in PostHog. Can modify questions, appearance, conditions, and other settings.

Delete Survey

Delete a survey from PostHog. Use this to remove expired or unused surveys.

List Session Recordings

List session recordings in a PostHog project. Session recordings capture user interactions with your application.

Get Session Recording

Get details of a specific session recording in PostHog by ID.

List Recording Playlists

List session recording playlists in a PostHog project. Playlists allow you to organize and curate session recordings.

List Event Definitions

List all event definitions in a PostHog project. Event definitions represent tracked events with metadata like descriptions, tags, and usage statistics.

Get Event Definition

Get details of a specific event definition in PostHog. Returns comprehensive information about the event including metadata, usage statistics, and verification status.

Update Event Definition

Update an event definition in PostHog. Can modify description, tags, and verification status to maintain clean event schemas.

List Property Definitions

List all property definitions in a PostHog project. Property definitions represent tracked properties with metadata like descriptions, tags, types, and usage statistics.

Get Property Definition

Get details of a specific property definition in PostHog. Returns comprehensive information about the property including metadata, type, usage statistics, and verification status.

Update Property Definition

Update a property definition in PostHog. Can modify description, tags, property type, and verification status to maintain clean property schemas.

List Projects

List all projects in the organization. Returns project details including IDs, names, API tokens, and settings. Useful for getting project IDs needed by other endpoints.

Get Project

Get detailed information about a specific project by ID. Returns comprehensive project configuration, settings, and feature flags.

List Organizations

List all organizations the user has access to. Returns organization details including name, slug, membership level, and available product features.

Get Organization

Get detailed information about a specific organization by ID. Returns comprehensive organization settings, features, usage, and team information.