PostHog

Also an agent tool

data-analytics

PostHog public API (management surface): manage projects, insights, dashboards and dashboard tiles, events (list/query via HogQL), persons, cohorts, feature flags (+ local evaluation), annotations, actions, experiments, session recordings, groups, surveys, property/event definitions, and batch exports. Bearer personal-API-key auth against a configurable region host (US Cloud https://us.posthog.com by default, EU Cloud https://eu.posthog.com, or a self-hosted URL). Most endpoints are scoped to a project via a {project_id} path parameter. The ingestion /capture endpoint (project API key in the body) is a different auth model and is intentionally excluded. Change notifications use polling (recent events via the HogQL /query endpoint or updated persons); PostHog webhooks/destinations are configured in-app and are not a Zervanor-verifiable signed feed, so no signed webhook trigger is shipped.

Provider API docs ↗

64 actions · 1 triggers

The PostHog integration lets you connect PostHog to your automations with 64 actions and 1 triggers — and every action is also a tool an AI agent can call. Examples: List Projects, Get Project, Update Project, List Insights, Create Insight. No blank-canvas wiring — connect it and use it in your workflows.

Every action below is also a tool an AI agent can call — the same pack powers your workflows and your agents.

Triggers 1

Events in PostHog that can start a workflow.

polling

New PostHog events (polled)

Polls GET /api/projects/{project_id}/events/ on a schedule using an 'after' timestamp watermark; dedups on event id.

Actions 64

What Zervanor can do in PostHog.

GET

List Projects

List the projects the personal API key can access (GET /api/projects/). Identity + connectivity probe.

GET

Get Project

Get a single project by id (GET /api/projects/{project_id}/).

PATCH

Update Project

Update a project's settings (PATCH /api/projects/{project_id}/).

GET

List Insights

List saved insights in a project (GET /api/projects/{project_id}/insights/). Offset pagination.

POST

Create Insight

Create a saved insight (POST /api/projects/{project_id}/insights/).

GET

Get Insight

Get a saved insight by id (GET /api/projects/{project_id}/insights/{id}/).

PATCH

Update Insight

Update a saved insight (PATCH /api/projects/{project_id}/insights/{id}/).

PATCH

Delete Insight

Soft-delete a saved insight (PATCH /api/projects/{project_id}/insights/{id}/ with deleted=true).

GET

List Dashboards

List dashboards in a project (GET /api/projects/{project_id}/dashboards/). Offset pagination.

POST

Create Dashboard

Create a dashboard (POST /api/projects/{project_id}/dashboards/).

GET

Get Dashboard

Get a dashboard by id, including its tiles (GET /api/projects/{project_id}/dashboards/{id}/).

PATCH

Update Dashboard

Update a dashboard, including adding/removing tiles (PATCH /api/projects/{project_id}/dashboards/{id}/).

PATCH

Delete Dashboard

Soft-delete a dashboard (PATCH /api/projects/{project_id}/dashboards/{id}/ with deleted=true).

GET

List Events

List recent events in a project (GET /api/projects/{project_id}/events/). Supports after/before time filters and cursor pagination via the response 'next' URL.

GET

Get Event

Get a single event by id (GET /api/projects/{project_id}/events/{id}/).

POST

Run Query (HogQL)

Run a query against project data (POST /api/projects/{project_id}/query/). Supports HogQL and other node-based queries for ad-hoc event/person analysis.

GET

List Persons

List persons in a project (GET /api/projects/{project_id}/persons/). Offset/cursor pagination.

GET

Get Person

Get a person by id (GET /api/projects/{project_id}/persons/{id}/).

PATCH

Update Person

Update a person's properties (PATCH /api/projects/{project_id}/persons/{id}/).

DELETE

Delete Person

Delete a person and optionally their events (DELETE /api/projects/{project_id}/persons/{id}/).

GET

Get Person Activity

Get a person's recent activity/events (GET /api/projects/{project_id}/persons/{id}/activity/).

GET

List Cohorts

List cohorts in a project (GET /api/projects/{project_id}/cohorts/).

POST

Create Cohort

Create a cohort (POST /api/projects/{project_id}/cohorts/).

GET

Get Cohort

Get a cohort by id (GET /api/projects/{project_id}/cohorts/{id}/).

PATCH

Update Cohort

Update a cohort (PATCH /api/projects/{project_id}/cohorts/{id}/).

PATCH

Delete Cohort

Soft-delete a cohort (PATCH /api/projects/{project_id}/cohorts/{id}/ with deleted=true).

GET

List Feature Flags

List feature flags in a project (GET /api/projects/{project_id}/feature_flags/).

POST

Create Feature Flag

Create a feature flag (POST /api/projects/{project_id}/feature_flags/).

GET

Get Feature Flag

Get a feature flag by id (GET /api/projects/{project_id}/feature_flags/{id}/).

PATCH

Update Feature Flag

Update a feature flag (PATCH /api/projects/{project_id}/feature_flags/{id}/).

PATCH

Delete Feature Flag

Soft-delete a feature flag (PATCH /api/projects/{project_id}/feature_flags/{id}/ with deleted=true).

GET

Get Feature Flags (Local Evaluation)

Get all feature-flag definitions for local evaluation (GET /api/projects/{project_id}/feature_flags/local_evaluation/). Returns flags plus cohorts/group-type mapping for evaluating flags without per-call requests.

GET

List Annotations

List annotations in a project (GET /api/projects/{project_id}/annotations/).

POST

Create Annotation

Create an annotation (POST /api/projects/{project_id}/annotations/).

GET

Get Annotation

Get an annotation by id (GET /api/projects/{project_id}/annotations/{id}/).

PATCH

Update Annotation

Update an annotation (PATCH /api/projects/{project_id}/annotations/{id}/).

PATCH

Delete Annotation

Soft-delete an annotation (PATCH /api/projects/{project_id}/annotations/{id}/ with deleted=true).

GET

List Actions

List actions (defined event patterns) in a project (GET /api/projects/{project_id}/actions/).

POST

Create Action

Create an action (POST /api/projects/{project_id}/actions/).

GET

Get Action

Get an action by id (GET /api/projects/{project_id}/actions/{id}/).

PATCH

Update Action

Update an action (PATCH /api/projects/{project_id}/actions/{id}/).

PATCH

Delete Action

Soft-delete an action (PATCH /api/projects/{project_id}/actions/{id}/ with deleted=true).

GET

List Experiments

List experiments (A/B tests) in a project (GET /api/projects/{project_id}/experiments/).

POST

Create Experiment

Create an experiment (POST /api/projects/{project_id}/experiments/).

GET

Get Experiment

Get an experiment by id (GET /api/projects/{project_id}/experiments/{id}/).

PATCH

Update Experiment

Update an experiment (PATCH /api/projects/{project_id}/experiments/{id}/).

DELETE

Delete Experiment

Delete an experiment (DELETE /api/projects/{project_id}/experiments/{id}/).

GET

List Session Recordings

List session recordings in a project (GET /api/projects/{project_id}/session_recordings/).

GET

Get Session Recording

Get a session recording's metadata by id (GET /api/projects/{project_id}/session_recordings/{id}/).

DELETE

Delete Session Recording

Delete a session recording (DELETE /api/projects/{project_id}/session_recordings/{id}/).

GET

List Groups

List groups of a given group type in a project (GET /api/projects/{project_id}/groups/).

GET

Get Group

Get a single group by type index and key (GET /api/projects/{project_id}/groups/find/).

GET

List Surveys

List surveys in a project (GET /api/projects/{project_id}/surveys/).

POST

Create Survey

Create a survey (POST /api/projects/{project_id}/surveys/).

GET

Get Survey

Get a survey by id (GET /api/projects/{project_id}/surveys/{id}/).

PATCH

Update Survey

Update a survey, e.g. launch or stop it (PATCH /api/projects/{project_id}/surveys/{id}/).

PATCH

Delete Survey

Soft-delete a survey (PATCH /api/projects/{project_id}/surveys/{id}/ with deleted=true).

GET

List Property Definitions

List event property definitions in a project (GET /api/projects/{project_id}/property_definitions/).

GET

List Event Definitions

List event definitions (known event names) in a project (GET /api/projects/{project_id}/event_definitions/).

GET

List Person Property Definitions

List person property definitions in a project (GET /api/projects/{project_id}/property_definitions/ with type=person).

GET

List Batch Exports

List batch export configurations in a project (GET /api/projects/{project_id}/batch_exports/).

POST

Create Batch Export

Create a batch export (POST /api/projects/{project_id}/batch_exports/) to a destination such as S3, BigQuery, or Snowflake.

GET

Get Batch Export

Get a batch export configuration by id (GET /api/projects/{project_id}/batch_exports/{id}/).

DELETE

Delete Batch Export

Delete a batch export configuration (DELETE /api/projects/{project_id}/batch_exports/{id}/).

Automations using PostHog

Build your own automation with PostHog in the visual builder.

Frequently asked questions

What can I automate with PostHog?

64 actions are available — for example: List Projects, Get Project, Update Project, List Insights, Create Insight, and more.

Which PostHog events can start a workflow?

1 triggers — for example: New PostHog events (polled).

Can PostHog be used as an AI agent tool?

Yes. Every PostHog action automatically becomes a tool an AI agent can call — the same pack powers both your workflows and your agents.

How is the PostHog integration modelled?

PostHog is modelled as a versioned connector pack, and the steps that need reasoning fall to first-party agents hosted in the same runtime as the workflows.