PostHog

Product analytics platform API for querying events, managing feature flags, running experiments, and accessing session replays. Best for workflows that need to read analytics data, toggle feature flags programmatically, or automate experiment management. Unlike Mixpanel or Amplitude, PostHog is open-source with a self-hostable option. 10 example endpoints available through Lava’s AI Gateway. See the PostHog API docs for full documentation.

This provider requires your own credentials — connect your API key or OAuth account before use.

This is a catch-all provider — any valid URL under https://us.posthog.com is supported. Any PostHog API endpoint. Construct URL as https://us.posthog.com/api/{path}. For direct external source SQL, use POST /api/projects/{project_id}/query/ and follow the nested direct query example. See https://posthog.com/docs/api for full reference. The endpoints below are curated examples.

Endpoints

Run an analytics query (HogQL, trends, funnels)

POST https://us.posthog.com/api/environments/{env_id}/query/ — Free

SDK
cURL

const data = await lava.gateway('https://us.posthog.com/api/environments/{env_id}/query/', {
  body: {
"query": {
  "kind": "HogQLQuery",
  "query": "SELECT count() FROM events"
}
},
});

curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fus.posthog.com%2Fapi%2Fenvironments%2F%7Benv_id%7D%2Fquery%2F" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":{"kind":"HogQLQuery","query":"SELECT count() FROM events"}}'

Run native SQL against a direct external data source. Keep connectionId and sendRawQuery nested inside query.

POST https://us.posthog.com/api/projects/{project_id}/query/ — Free

SDK
cURL

const data = await lava.gateway('https://us.posthog.com/api/projects/{project_id}/query/', {
  body: {
"query": {
  "kind": "HogQLQuery",
  "query": "SELECT 1 AS test",
  "connectionId": "{external_data_source_id}",
  "sendRawQuery": true
}
},
});

curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fus.posthog.com%2Fapi%2Fprojects%2F%7Bproject_id%7D%2Fquery%2F" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":{"kind":"HogQLQuery","query":"SELECT 1 AS test","connectionId":"{external_data_source_id}","sendRawQuery":true}}'

List feature flags

GET https://us.posthog.com/api/projects/{project_id}/feature_flags/ — Free

SDK
cURL

const data = await lava.gateway('https://us.posthog.com/api/projects/{project_id}/feature_flags/', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fus.posthog.com%2Fapi%2Fprojects%2F%7Bproject_id%7D%2Ffeature_flags%2F" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

Query events

GET https://us.posthog.com/api/projects/{project_id}/events/ — Free

SDK
cURL

const data = await lava.gateway('https://us.posthog.com/api/projects/{project_id}/events/', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fus.posthog.com%2Fapi%2Fprojects%2F%7Bproject_id%7D%2Fevents%2F" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

List persons (users)

GET https://us.posthog.com/api/projects/{project_id}/persons/ — Free

SDK
cURL

const data = await lava.gateway('https://us.posthog.com/api/projects/{project_id}/persons/', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fus.posthog.com%2Fapi%2Fprojects%2F%7Bproject_id%7D%2Fpersons%2F" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

List saved insights

GET https://us.posthog.com/api/projects/{project_id}/insights/ — Free

SDK
cURL

const data = await lava.gateway('https://us.posthog.com/api/projects/{project_id}/insights/', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fus.posthog.com%2Fapi%2Fprojects%2F%7Bproject_id%7D%2Finsights%2F" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

List dashboards

GET https://us.posthog.com/api/projects/{project_id}/dashboards/ — Free

SDK
cURL

const data = await lava.gateway('https://us.posthog.com/api/projects/{project_id}/dashboards/', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fus.posthog.com%2Fapi%2Fprojects%2F%7Bproject_id%7D%2Fdashboards%2F" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

Replace a feature flag

PUT https://us.posthog.com/api/projects/{project_id}/feature_flags/{flag_id}/ — Free

SDK
cURL

const data = await lava.gateway('https://us.posthog.com/api/projects/{project_id}/feature_flags/{flag_id}/', { method: 'PUT', body: {"name":"my-flag","key":"my-flag","active":true} });

curl -X PUT "https://api.lava.so/v1/forward?u=https%3A%2F%2Fus.posthog.com%2Fapi%2Fprojects%2F%7Bproject_id%7D%2Ffeature_flags%2F%7Bflag_id%7D%2F" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"my-flag","key":"my-flag","active":true}'

Update a feature flag

PATCH https://us.posthog.com/api/projects/{project_id}/feature_flags/{flag_id}/ — Free

SDK
cURL

const data = await lava.gateway('https://us.posthog.com/api/projects/{project_id}/feature_flags/{flag_id}/', { method: 'PATCH', body: {"active":true} });

curl -X PATCH "https://api.lava.so/v1/forward?u=https%3A%2F%2Fus.posthog.com%2Fapi%2Fprojects%2F%7Bproject_id%7D%2Ffeature_flags%2F%7Bflag_id%7D%2F" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"active":true}'

Delete an annotation

DELETE https://us.posthog.com/api/projects/{project_id}/annotations/{annotation_id}/ — Free

SDK
cURL

const data = await lava.gateway('https://us.posthog.com/api/projects/{project_id}/annotations/{annotation_id}/', { method: 'DELETE' });

curl -X DELETE "https://api.lava.so/v1/forward?u=https%3A%2F%2Fus.posthog.com%2Fapi%2Fprojects%2F%7Bproject_id%7D%2Fannotations%2F%7Bannotation_id%7D%2F" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json"

Get Started

AI Gateway

AI Spend

Monetize

Integration

SDK

Cookbook

Comparisons

Endpoints

Run an analytics query (HogQL, trends, funnels)

Run native SQL against a direct external data source. Keep connectionId and sendRawQuery nested inside query.

List feature flags

Query events

List persons (users)

List saved insights

List dashboards

Replace a feature flag

Update a feature flag

Delete an annotation

Next Steps

All Providers

Forward Proxy

​Endpoints

​Run an analytics query (HogQL, trends, funnels)

​Run native SQL against a direct external data source. Keep connectionId and sendRawQuery nested inside query.

​List feature flags

​Query events

​List persons (users)

​List saved insights

​List dashboards

​Replace a feature flag

​Update a feature flag

​Delete an annotation

​Next Steps

All Providers

Forward Proxy

Endpoints

Run an analytics query (HogQL, trends, funnels)

Run native SQL against a direct external data source. Keep connectionId and sendRawQuery nested inside query.

List feature flags

Query events

List persons (users)

List saved insights

List dashboards

Replace a feature flag

Update a feature flag

Delete an annotation

Next Steps