Posthog Integration for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Posthog MCP or direct API to analyze funnels, monitor user behavior, trigger alerts, and generate retention reports through natural language.
BOOK A CALLGET STARTED FOR FREE
Posthog Logo
Gradient Top
Gradient Middle
Gradient Bottom
divider

Supported Tools

Tools
Add dashboard collaborators with access levelAdd collaborators to a specific project dashboard.
Add member to organization roleAdd a member to an organization role by submitting their details and uuid in json/form, using organization and role ids.
Add project specific member rolesAdd members with specific roles to a project by providing their user uuid and level (member or admin).
Assign feature flag role based accessSet up role-based access for a feature flag using `project id` and `feature flag id`.
Bookmark project activity notificationCreate a bookmark for an activity notification in a project's activity log.
Bulk create organization invitesPost /api/organizations/{organization id}/invites/bulk/: bulk-create organization invites with customizable levels, sender details, and validation checks.
Cancel insights for a projectThe "/api/projects/{project id}/insights/cancel/" endpoint allows users to cancel insights for a project by providing a project id and insight details in json or csv, and confirms cancellation in the response.
Check pipeline destination updatesGet the newest updates and plugin info for a pipeline destination by organization and destination id via get request to /api/.
Check pipeline import app updatesRetrieve the latest update information for a specific pipeline import app by its id within an organization.
Check pipeline plugin update statusGet update status for a specific pipeline transformation plugin by its unique id within an organization.
Check project s demo data generation statusProjects for the current organization.
Cohort duplication to staticThis endpoint duplicates a specified cohort as a static one within a project.
Create a notebook in a projectThe api for interacting with notebooks.
Create project insights with customizable parametersThe post endpoint enables creating insights for projects using a project id and supports json/csv.
Create dashboard from template in projectCreate a new dashboard for a specified project from a template.
Create domain with saml for organizationCreate a domain for a specific organization by post to `/api/organizations/{id}/domains` with json/form data.
Create experiment exposure cohortCreate a new exposure cohort for an experiment in a project by sending a post request with experiment details and feature flag data.
Create feature flag dashboardManage feature flags by creating, reading, updating, and deleting them.
Create feature flags for projectManage feature flags by creating, reading, updating, and deleting them using posthog's javascript library or api endpoint.
Create frontend app pipeline configCreate a config for pipeline frontend apps within a specified project.
Create funnel analysis for project personsThis endpoint handles reading and deleting persons.
Create new organization with configurable accessPost /api/organizations/ - create a new organization with details like name, membership level, and features access.
Create new project experimentCreate a new experiment in a specific project using json, form, or multipart data.
Create organization invite with role and emailSend invites with roles (member, admin, owner) via email to join an organization by id.
Create organization role with feature flag levelsCreate a new role for the specified organization by supplying role details.
Create org proxy record with domain and statusCreate a proxy record for an org by sending org id in url and json/form/multipart data with domain, target cname, and status.
Create person funnel correlationThis endpoint is for reading and deleting persons.
Create person path with format optionThis api endpoint is for reading and deleting users.
Create pipeline destination configCreate pipeline destination configurations for a specific project by submitting plugin and order details, among other configuration info, with required project id.
Create pipeline destination config jobCreate a job for a pipeline destination config with a specific id within the specified project.
Create pipeline import apps config jobA job imports app settings into a project pipeline using project id and plugin config id, accepting json/form/multipart, and specifies plugin details, enabling status, and order for pipeline import apps configs.
Create plugin job configurationCreate a job-related configuration for a specific plugin by providing plugin and project ids.
Create project action with formatThis post endpoint creates actions for a project, accepts various data types, requires project id and action data, optionally outputs in csv/json, and needs personalapikeyauth, returning a 201 with action details.
Create project cohortsCreate cohorts for a specified project by posting json-form data to "/api/projects/{project id}/cohorts/".
Create project dashboardThe post endpoint creates a dashboard within a project using a `project id`, accepting details in json/form formats.
Create project insights with format optionCreate project insights with optional csv/json format parameter.
Create project pipeline app configsCreate pipeline app configurations for a specified project via post, requiring a project id and json, form, or multipart payload.
Create project pipeline frontend app jobCreate a job for a pipeline frontend app config in a project.
Create project pipeline transformation configCreate a pipeline transformation config within a specific project by posting json, form, or multipart data.
Create project plugin configurationCreate a new plugin configuration for a specified project by post to /api/projects/{project id}/plugin configs/.
Create project subscription with delivery optionsCreate a subscription for a given project by providing required details such as delivery method, frequency, and starting date.
Create project surveys with questions and targetsCreate surveys in a project by providing a project id and details like type, questions, and targets in json, form-data, or urlencoded format.
Create project timing insightsCreate timing insights for a project by post to /api/projects/{project id}/insights/timing, supporting csv or json.
Create query in project by idThe `/api/projects/{project id}/query/` post endpoint allows users to submit queries for a specific project by providing the project id in the url and the query details in json or form data.
Create retrieve retention insights for projectCreate and retrieve retention insights for a project using its id, allowing csv/json outputs.
Create session recording in playlistThe post endpoint generates a project's session recording, needing 'project id', 'short id', and 'session recording id' in the url, and accepts various content formats for recording details.
Create session recording playlistsCreate playlists of session recordings for a specified project.
Create session recording summarySummarize a session recording by providing the project id and the recording's uuid.
Create static cohort for feature flagManage feature flags for apps with create, read, update, and delete operations using posthog's javascript library or dedicated endpoint.
Crud operations for project annotationsCreate, read, update and delete annotations.
Project Funnel Advanced AnalyticsThe `/api/projects/{project id}/insights/funnel/` endpoint generates customizable funnel insights for a project in either csv or json, offering filtering, exclusion, and ordering features with cachable results.
Delete organization by uuidDelete an organization by its uuid.
Delete organization projectProjects for the current organization.
Delete person and optionally associated eventsThis endpoint is used to read and delete user data.
Delete session recording by uuidDelete a session recording by providing the session's uuid and the associated project id.
Delete survey by idDelete a survey by providing its uuid and the associated project id.
Enable project early access featureEnables a new early access feature for a project using project id, payload with details, and personalapikeyauth.
Fetch batch export details via uuidRetrieve logs for a specific batch export within a project by its uuid.
Fetch export unsubscribe settingsRetrieve pipeline transformation export unsubscribe configurations for a specified organization by its uuid.
Fetch frontend app config statusRetrieve activity details for a specific pipeline frontend app config by id within a project.
Fetch organization details by uuidRetrieve organization details by uuid.
Fetch organization pipeline app repositoriesRetrieve details of pipeline import app repositories for a specific organization by its uuid.
FetchpipelinedestinationdetailsUse a get request to '/api/projects/{project id}/pipeline destination configs/{id}/activity/' to get details, status, config, and metrics for a pipeline destination by id, returning json.
Fetch pipeline transformation detailsRetrieve details of pipeline transformations from a specified organization's repository.
Fetch project experiment secondary dataFetch secondary experiment data in a project by its unique id, using project and experiment ids as path parameters.
Fetch project survey activity logRetrieve the activity log of surveys within a specific project by using the project id.
Fetch session recording playlist detailsRetrieve session recording playlist details for a specific project by project id and playlist short id.
Flag annotation as deletedHard delete of this model is not allowed.
Generate project funnel correlation insightThe /api/projects/{project id}/insights/funnel/correlation endpoint generates a correlation insight for funnel analysis in a project, accepting json/csv and needing 'project id' and insight details.
Retrieve unused organization pipeline frontend appsRetrieve unused pipeline frontend apps for a specific organization by its uuid.
Initiate domain verification with saml configPost /api/organizations/{organization id}/domains/{id}/verify/: initiates verification for a domain within an organization using its uuid, updating its verification status and related saml configuration attributes.
Initiate pipeline transformation jobCreate a pipeline transformation job for a specified plugin config in a project by posting to `/api/projects/{project id}/pipeline transformation configs/{id}/job/`.
List and filter project eventsThis endpoint for listing/filtering events is deprecated and maintained only for compatibility.
List and manage project annotationsCreate, read, update and delete annotations.
List and manage project feature flagsManage feature flags with creation, reading, updating, and deletion capabilities.
List Batch Export RunsList runs for a batch export by `batch export id` within a project.
List dashboard sharing configsRetrieve a list of dashboard sharing configurations for a specified project and dashboard.
List feature flag role access detailsThis get endpoint returns role access details for a feature flag in a project, needs 'project id' & 'feature flag id', and offers optional 'limit' & 'offset' for pagination.
List notebooks with filters and paginationThe api for interacting with notebooks.
List of project s session recording playlistsRetrieve a list of session recording playlists for a specific project.
List or delete persons with optional filtersThis endpoint is for reading/deleting persons.
List organization domains with paginationFetch a list of an organization's domains with pagination using `limit` and `offset`.
List organization invites with paginationRetrieve a paginated list of invites for a specific organization, identified by `organization id`, with optional `limit` and `offset` query params for result customization.
List organization members with paginationRetrieve members list from an organization with 'limit' and 'offset' options using personalapikeyauth and organization id.
ListorganizationpluginswithpaginationRetrieve the list of plugins for a specified organization.
List organization roles with paginationFetch a paginated list of roles in an organization using its uuid.
List organization s batch exports with paginationRetrieve paginated batch exports for an organization, with filters and optional limits.
List organization s paginated proxy recordsRetrieve a paginated list of an organization's proxy records by id, with 'limit' and 'offset' options.
List organization s pipeline destinationsRetrieve a paginated list of an organization's pipeline destinations by id, with optional count and offset parameters.
List organization s pipeline frontend appsRetrieve a paginated list of pipeline apps for an organization using 'plugin:read' personalapikeyauth.
List organization s pipeline import appsRetrieve a paginated list of pipeline import applications for a specified organization by id.
List organization s pipeline transformationsRetrieve paginated pipeline transformation lists for an organization using `limit` and `offset`, requiring a uuid and personalapikeyauth.
List paginated surveys for a projectGet paginated surveys for a project with its id, using 'limit' and 'offset'.
List pipeline destination configs with paginationList pipeline destination configurations for a given project by id, with optional pagination through 'limit' and 'offset' query parameters.
List pipeline frontend app configsRetrieve paginated configurations for pipeline frontend apps associated with a specified project.
List project actions with pagination and filtersGet paginated project actions with filters by format.
List project batch exports with paginationRetrieve an indexed list of batch exports for a specified project with optional pagination.
List project configuration plugin logsRetrieve logs for a specific plugin configuration within a project.
List project dashboard collaboratorsGet dashboard collaborators list in a project using project string id and dashboard integer id.
List project dashboards with paginationGet paginated dashboards for a project by id, using 'limit' and 'offset'.
List project dashboard templates"retrieve a paginated list of dashboard templates for a specified project.
List project early access featuresRetrieve a paginated list of a project's early access features by id with 'limit' and 'offset' parameters.
List project experiments with paginationGet a paginated list of experiments within a project using 'limit' and 'offset' parameters.
List project export items with paginationRetrieve a paginated list of export items for a specific project by id with optional 'limit' and 'offset' query parameters.
List project group types by idRetrieve a list of group types within a specific project by providing the project id.
List project membership detailsRetrieve a list of project membership details for a specified project by id.
List project pipeline configurationsFetch paginated pipeline configuration list for a project by its id, utilizing optional `limit` and `offset`.
ListprojectpipelineimportconfigsList pipeline import app configurations for a specified project, with pagination options 'limit' and 'offset'.
List project plugin configurationsRetrieve a paginated list of plugin configurations for a specific project by project id.
List project session recordingsRetrieve a paginated list of session recordings for a specific project, including viewing times and user interactions.
List projects in organization with paginationProjects for the current organization.
List project subscriptions with paginationRetrieve a paginated list of subscriptions for a given project by its id.
ListrolemembershipspaginatedRetrieve a paginated list of role memberships for a specific role within an organization, including membership details.
List session recording sharing configsRetrieve a list of sharing configurations for a specific session recording in a project, including creation timestamps and access tokens.
List specific type groups with paginationList all groups of a specific group type.
List unused organization pipeline transformationsRetrieve a list of unused pipeline transformations for a specified organization, identified by uuid.
List users with staff filter and paginationApi endpoint fetches a user list with staff filter, pagination (limit, offset), and requires a personal api key.
Manage feature flag enrichment for usage dashboardLearn to manage feature flags (creation, access, modification, removal) using posthog's docs, with options to use a javascript library or a dedicated endpoint for user-specific flag status.
Manage project feature flagsLearn to manage feature flags: create, read, update, delete, and check their status using the javascript library or an endpoint.
Manage project feature flags for local evaluationUtilize feature flags to manage application features with creation, reading, updating, and deletion.
Manage user feature flagsManage feature flags in your app with create, read, update, and delete options.
Mark dashboard template as deletedHard delete of this model is not allowed.
Mark insight as viewed with configurable formatThe post endpoint marks an insight as viewed for a specified project, requires `project id` and `id`, supports `csv` or `json` formats, and returns fast-loading serialized data.
Mark project action as deletedHard delete of this model is not allowed.
Mark session recording playlist deletedHard delete of this model is not allowed.
Mark subscription as deleted by idHard delete of this model is not allowed.
Modify org info via uuidPut /api/organizations/{id}/: update organization details by providing a uuid as 'id'.
Move dashboard tileEndpoint to move a tile within a dashboard by `id`.
Partial experiment update in projectEndpoint enables partial updates to an experiment in a project using patch, needing `project id`, `experiment id`, and various payload types.
Partially update project plugin configUpdate plugin configuration partially for a specified project using patch on '/api/projects/{project id}/plugin configs/{id}'.
Partially update project property definitionPatch /api/projects/{project id}/property definitions/{id}/: partially update a specific property definition by uuid in a project.
Partial pipeline frontend app config updatePatch method to partially update config of a pipeline frontend app for a project by id.
Partial update of a project insightThe patch endpoint supports partial insight updates in a project, allows format specification (csv/json), and requires `personalapikeyauth` and `insight:write` scope for access.
Partial update of a project s dashboardEndpoint patch /api/projects/{project id}/dashboards/{id}: allows partial update of a project's dashboard with specified id.
Partial update of a project s feature flagLearn to manage feature flags (create, read, update, delete) using posthog's docs, with options for javascript library use or dedicated endpoints for user flag status.
Partial update of project notebookThe api for interacting with notebooks.
Partial update project annotationCreate, read, update and delete annotations.
Persist session recording data by uuidPost `/api/projects/{project id}/session recordings/{id}/persist`: endpoint for persisting session recording data identified by uuid.
Person partial update via project idThis endpoint allows reading and deleting individuals.
Person property deletion endpointThis endpoint is for reading and deleting user data.
Prevent hard delete notebook by flaggingHard delete of this model is not allowed.
Post Project Trends With FiltersThe `/api/projects/{project id}/insights/trend/` endpoint provides project trends in csv/json, requires `project id` and optional parameters, and needs 'personalapikeyauth'.
Rearrange frontend app pipeline configsPatch /api/projects/{project id}/pipeline frontend apps configs/rearrange/: rearrange the config of frontend apps in a project's pipeline.
Rearrange pipeline transformation configsEndpoint `/api/projects/{project id}/pipeline transformation configs/rearrange/` allows for partial updates to the arrangement of pipeline configurations for a given project.
Rearrange project import app configurationsRearrange app import settings in a project using patch /api/projects/{project id}/.
Rearrange project pipeline destination configs"patch /api/projects/{project id}/pipeline destination configs/rearrange/": adjust order and settings of pipeline destinations for a project by project id.
Reconfigure plugin order and status in projectPatch endpoint to reconfigure the order of plugins within a project by project id.
Remove domain by uuid from organizationDelete a specific domain by its uuid within an organization, given valid organization and domain ids.
Remove early access feature from projectDelete an early access feature by id from a specified project.
Remove explicit project member by uuidDelete a specific user (by uuid) from the explicit members of a given project.
Remove feature flag role access by idDelete /api/projects/{project id}/feature flags/{feature flag id}/role access/{id}: remove role access from a feature flag in a project by id, requiring authorization.
Remove member from organization by uuidDelete /api/organizations/{org id}/members/{user uuid}: removes a specific member from an organization using uuids for both entities.
Remove organization batch export by uuidDelete a specific batch export by its uuid in an organization.
Remove organization pipeline destinationDelete a specific pipeline destination in an organization by id.
Remove organization pipeline transformationDelete a specific pipeline transformation plugin for an organization by id.
Remove organization plugin by idDelete a specific plugin (by its integer id) from the organization (identified by uuid) with no response body on success.
Remove organization proxy recordDelete a proxy record by id for a specific organization.
Remove organization role by idDelete a role with a specific uuid in an organization.
Remove org pipeline import app by idDelete a specific pipeline import app plugin associated with an organization by id.
Remove pipeline destination configDelete a pipeline destination configuration by specifying a unique integer id within a project.
Remove pipeline frontend app by idDelete a specific pipeline frontend app by its id within an organization.
Remove pipeline frontend app configDelete a pipeline frontend app configuration for a specific project.
Remove pipeline import app configDelete a specific pipeline import app configuration using its id within a project.
Remove pipeline transformation config by idDelete a specific pipeline transformation configuration by id within a project.
Remove project dashboard collaboratorRemove a collaborator from a project dashboard.
Remove project event definitionDelete an event definition by providing its uuid and the associated project id.
Remove project experiment by idDelete a specific experiment by its unique integer id within a project.
Remove project plugin configurationDelete /api/projects/{project id}/plugin configs/{id}/: removes a specific plugin configuration by id from a given project.
Remove property definition by uuidDelete a property definition by providing its uuid and the associated project id.
Remove rolemembership by uuidDelete /api/organizations/{org id}/roles/{role id}/role memberships/{id}: removes a role membership from an organization using a specific uuid.
Remove session recording from playlistDelete a session recording from a playlist using its id within a specified project.
Remove specific project batch exportDelete a specific batch export by providing the uuid and project id.
Remove specific project query(experimental)
Retrieve and delete project person trendsThis endpoint is for reading and deleting persons.
Retrieve app metrics by idsRetrieve app-specific metrics for a given project by providing the project id and app metric id.
Retrieve app metrics error detailsRetrieves detailed error information for a specific app metric by id within a project.
Retrieve async query status by id(experimental)
Retrieve batch export detailsRetrieve details of a specific batch export by its uuid in a project.
Retrieve batch export logs by uuidRetrieve logs for a specific batch export given by uuid within an organization.
Retrieve batch export run logsRetrieve logs for a specific batch export run within a project.
Retrieve cohort activity detailsRetrieve activity details for a specific cohort within a project.
Retrieve cohort person detailsRetrieve details of persons within a cohort by its unique id in the specified project.
Retrieve dashboard template details by uuidFetch specific dashboard template details by uuid in a project with 'dashboard template:read' rights using a personalapikeyauth.
Retrieve dashboard template schemaRetrieve the json schema for dashboard templates of a specific project.
Retrieve event definition by uuidRetrieve an event definition by its uuid within a specified project.
Retrieve event definitions by project idRetrieve definitions for events within a specified project by providing the unique project id.
Retrieve experiment details by idsAccess detailed experiment info within a project using unique `experiment id` & `project id`, with 'experiment:read' rights.
Retrieve experiments requiring flag implementationRetrieve details for experiments that require feature flag implementation in a specific project.
Retrieve export unsubscribe configsRetrieve the configuration for unsubscribing from exports in the pipeline import apps for a specific organization.
Retrieve feature flag activity detailsManage feature flags (creation, reading, updating, and deleting) using posthog's guides or via javascript library/endpoint for user-specific flag status.
Retrieve feature flag detailsThis guide details how to manage (create, read, update, delete) feature flags in applications using posthog's javascript library or endpoint.
Retrieve feature flag role access detailsRetrieve details for a specific role's access to a feature flag within a project.
Retrieve feature flags activity logLearn to manage feature flags by creating, reading, updating, and deleting them.
Retrieve feature flags evaluation reasonsManage feature flags—create, read, update, delete—using the posthog javascript library or endpoint for user-specific flag status.
Retrieve filtered project property definitionsGet property definitions for a project using project id, with filters for event names, property types, exclusions, and numerical or feature flags.
Retrieve funnel insights in projectGain insights from funnel analysis of a specific project by providing its id and having 'insight:read' permission.
Retrieve group property definitions by project idRetrieve property definitions for a group within a project by providing the project id.
Retrieve group property values by index and keyRetrieve property values by 'group type index' and 'key' within a 'project id'.
Retrieve hedgehog configuration by uuidRetrieve user's hedgehog configuration details by their uuid.
Retrieve historical app metrics exportRetrieve historical export data for app metrics by supplying the `project id` and `plugin config id`.
Retrieve important project activity logRetrieve a log of important changes for a specified project.
Retrieve insight sharing configurationsRetrieve sharing configurations for a specific insight within a project, requiring project and insight ids.
Retrieve last viewed insights for userReturns basic details about the last 5 insights viewed by this user.
Retrieve matching events for session recordingRetrieves event ids matching a filter with one session id and at least one event/action criterion.
Retrieve notebook activity for projectThe api for interacting with notebooks.
Retrieve notebook activity logThe api for interacting with notebooks.
Retrieve notebook detailsThe api for interacting with notebooks.
Retrieve or delete person retention dataThis endpoint is for reading and deleting person data; use the capture api, `$set`/`$unset` properties, or sdks for creation and updates.
Retrieve or delete project persons funnel dataThis api endpoint is for reading and deleting user data.
Retrieve organization pipeline frontend app detailsRetrieve pipeline frontend app details for an organization using its 'organization id' (uuid).
Retrieve organization pipeline unsubscribe configsRetrieve unsubscribe config details for an organization's pipeline frontend apps.
Retrieve organization plugin activityRetrieve activity details for plugins in a specified organization by id.
Retrieve organization plugin detailsRetrieve a specific plugin's details for an organization.
Retrieve organization plugin repository detailsRetrieve plugin repository details for a specific organization by its uuid, including plugin type, name, url, and more.
Retrieve organization plugin unsubscribe configsRetrieve plugin export unsubscribe configurations for a specified organization by organization id.
Retrieve organization project detailsProjects for the current organization.
Retrieve organization role detailsRetrieve the details of a specific role within an organization using its uuid.
Retrieve Org Pipeline Repo DetailsRetrieve details for repository pipeline destinations within a specific organization by its uuid.
Retrieve organization s unused pipeline appsRetrieve unused pipeline import apps for a specified organization.
Retrieve org pipeline transformation activityRetrieve pipeline transformation activity details for a specific organization using its uuid.
Retrieve paginated organization listRetrieve a paginated list of organizations with optional 'limit' and 'offset' query parameters.
Retrieve person details by idThis endpoint is used to read and delete persons.
Retrieve person details by projectThis endpoint allows reading and deleting persons; for creation or updates, use the capture api, the `$set` and `$unset` properties, or sdks.
Retrieve person lifecycle detailsThis endpoint is for reading and deleting persons.
Retrieve person properties timelineThis endpoint allows reading and deleting individuals.
Retrieve person s activity and delete optionsThis endpoint is for reading and deleting persons; for creating/updating, use the capture api, `$set`/`$unset` properties, or sdks.
Retrieve persons funnel correlation dataThis endpoint is for reading and deleting persons.
Retrieve person values by projectThis endpoint is for reading and deleting persons.
Retrieve pipeline destination activityRetrieve activity details for pipeline destinations within an organization.
Retrieve pipeline destination config detailsRetrieve details of a specific pipeline destination config for a project by its id.
Retrieve pipeline destination detailsFetch a pipeline destination's details by id and organization uuid, using a personalapikeyauth with read access to plugins.
Retrieve pipeline destination frontend configRetrieve configuration details for a specific pipeline destination in a project by getting the frontend data of the config with a given id.
Retrieve pipeline destination plugin detailsRetrieve details of a specific pipeline destination plugin within an organization by its unique id.
Retrieve pipeline frontend app activityRetrieve activity details for pipeline front-end apps within a specified organization by organization id.
Retrieve pipeline frontend app detailsRetrieves details of a specified pipeline frontend app within an organization.
Retrieve pipeline frontend app source detailsRetrieve details for a specific pipeline frontend app's source by its id within an organization.
Retrieve pipeline frontend plugin configRetrieve the frontend configuration for a specific plugin in a project's pipeline.
Retrieve pipeline import app detailsAccess specific pipeline import app details in an organization using its id and a valid organization uuid.
Retrieve pipeline import apps activityRetrieve activity details of pipeline import apps for a given organization.
Retrieve pipeline import app source detailsRetrieves source details of a pipeline import app by its id within a specified organization.
Retrieve pipeline plugin details by idRetrieve pipeline transformation plugin details by id for a specified organization.
Retrieve Pipeline Plugin SourceRetrieve the source details of a pipeline transformation for a specific plugin by id within an organization.
Retrieve pipeline transformation activityRetrieve the activity details of a specific pipeline transformation configuration in a project using its unique integer id.
Retrieve pipeline transformation configRetrieve the configuration for a specific pipeline transformation plugin in a project by its id using a get request.
Retrieve pipeline transformation frontend configRetrieve the frontend configuration details for a specific pipeline transformation by id within a given project.
Retrieve plugin config activityRetrieve activity details for a specific plugin config within a project's pipeline import apps.
Retrieve plugin config activity detailsRetrieve activity details for a specific plugin configuration within a project.
Retrieve plugin config detailsRetrieve the configuration details of a specific plugin by its id for a given project.
Retrieve plugin config frontendRetrieve the frontend configuration of an app's pipeline import by id within a specified project.
Retrieve plugin frontend configRetrieve the frontend configuration of a specific plugin for a given project.
Retrieve plugin source detailsRetrieve plugin source details by organization and plugin id.
Retrieve plugin update infoThis endpoint retrieves update information for a specific plugin within an organization's pipeline frontend app by its integer id and the organization's uuid.
Retrieve plugin update statusRetrieve the latest update status for a specific plugin, identified by its integer id, within an organization specified by uuid.
Retrieve project action details by idGet details on a project action by id.
Retrieve project activity detailsProjects for the current organization.
Retrieve project activity insightsRetrieve activity insights for a specific project by project id, supporting csv or json formats.
Retrieve project activity log with paginationAccess a project's activity log using pagination and cursor-based navigation.
Retrieve project annotation detailsCreate, read, update and delete annotations.
Retrieve project cohort detailsRetrieve detailed information about a specific cohort within a project using its id.
Retrieve project cohorts activity logRetrieve activity log for a specific project's cohorts.
Retrieve project cohorts with paginationRetrieve a paginated list of cohorts for a specific project using `project id`.
Retrieve project draft sql queryRetrieve the draft sql query for a specific project using its project id.
Retrieve project early access feature detailsRetrieve details of a specific early access feature in a project by id.
Retrieve project event details by idRetrieve details for a specific event by id within a project.
Retrieve project event valuesRetrieve event values for a specific project by id.
Retrieve project experiment resultsRetrieve experiment results within a project by project and experiment id.
Retrieve project export detailsRetrieve detailed info on a specific export of a project using its unique id.
Retrieve project funnel correlation insightsRetrieve insights about funnel correlations for a specific project by id, offering results in json or csv.
Retrieve project group details by key and typeRetrieves specified group details within a project by group key and type index.
Retrieve project insight activity dataRetrieve insights activity for a specific project and insight id, offering data in json or csv format.
Retrieve project insight detailsRetrieve details for a specific project insight by id, with options to format as json/csv, request refresh, and specify dashboard context.
Retrieve project insights detailsRetrieve detailed insights for a specific project using its id.
Retrieve project insights with paginationThe get `/api/projects/{project id}/insights/` endpoint retrieves a paginated list of insights for a specified project.
Retrieve project member details by uuidRetrieve detailed information about a specific user's membership level and status within a project by their uuid.
Retrieve project person activityThis endpoint allows reading and deleting individuals.
Retrieve project person cohortsThis endpoint allows reading and deletion of persons; for creation or updates, use the capture api, `$set`/`$unset` properties, or sdks.
Retrieve project person stickinessThis endpoint allows for reading and deleting persons.
Retrieve project pipeline plugin configRetrieve configuration details of a specific plugin for a given project pipeline by id.
Retrieve project session valuesRetrieve session values for a specified project.
Retrieve project subscription detailsRetrieve a specific subscription for a project, identified by 'project id' and 'id'.
Retrieve project trend insightsRetrieve trend insights for a specific project, supporting csv or json formats.
Retrieve properties and events associationAllows a caller to provide a list of event names and a single property name returns a map of the event names to a boolean representing whether that property has ever been seen with that event name
Retrieve property definition detailsRetrieve details of a specific property definition by uuid within a project.
Retrieve proxy record detailsRetrieve a specific proxy record's details by id within an organization.
Retrieve related project groupsRetrieve related groups for a specific project and user.
RetrieveretentioninsightsRetrieve retention insights for a specified project.
Retrieve session property definitionsRetrieve property definitions for a specific project by providing the project's id.
Retrieve session recording detailsRetrieve detailed information about a specific session recording by providing the session's uuid and associated project id.
Retrieve session recording error clustersRetrieve error clusters from session recordings for a specified project.
Retrieve session recording playlist detailsRetrieve session recording playlists for a specified project and playlist short id.
Retrieve session recording propertiesRetrieve properties of session recordings for a given project by id, including activity metrics, timestamps, and participant details.
Retrieve session recording snapshotsSnapshots for a session can be loaded from s3 (if old) or redis (if recent).
Retrieve similar session recordingsRetrieve similar session recordings for a given session by uuid within a project.
Retrieve specific batch export detailsRetrieve details of a specific batch export for an organization by its uuid.
Retrieve specific batch export run detailsRetrieve details for a specific batch export run within a project by id.
Retrieve specific domain detailsRetrieve details of a specific domain within an organization using its uuid.
Retrieve specific exported asset contentRetrieve the content of a specific exported asset by id within a project.
Retrieve specific historical plugin exportRetrieve historical export data for a specific plugin configuration within a project.
RetrievespecificpipelinefrontendappconfigRetrieve the configuration details of a specific pipeline frontend app by providing its unique id and the associated project id.
Retrieve specific project dashboard detailsRetrieve details of a specific dashboard within a project.
Retrieve survey activity logsRetrieve activity logs for specific survey in a project, identified by uuids.
Retrieve survey details with uuid and project idRetrieve survey details using survey uuid and associated project id.
Retrieve survey responses count by project idRetrieve the count of survey responses for a specific project by its id.
Retrieve unsubscribed pipeline configsRetrieve config details for unsubscribed pipeline destinations in an organization.
Retrieve unused organization pluginsRetrieve a list of unused plugins for a specified organization by its uuid.
RetrieveunusedpipelinedestinationsRetrieve unused pipeline destinations for a specified organization by id.
Retrieve user details for initiating 2fa setupThe endpoint `get /api/users/{uuid}/start 2fa setup/` fetches details for initiating 2fa setup for a user, providing information like email status, password presence, and more.
Retrieve user profile and team detailsFetch user info like profile, team, org, and notifications via uuid using personalapikeyauth ('user:read').
Revoke organization inviteDelete an organization invite by its uuid.
Set insight deletion flagHard delete of this model is not allowed.
Soft delete a specific cohort by idHard delete of this model is not allowed.
Soft delete feature flag by setting statusHard delete of this model is not allowed.
Soft delete project dashboardHard delete of this model is not allowed.
Split person entities in projectThis endpoint allows reading and deleting persons; for creation or updates, use the capture api, `$set`/`$unset` properties, or sdks.
Trigger project export with format optionThe `/api/projects/{project id}/exports/` endpoint triggers a project export, requiring `project id` and `export format`.
Update annotation detailsCreate, read, update and delete annotations.
Update early access project featureThis patch endpoint updates a specific early access project feature.
Update event definition by uuidUpdate an event definition by sending a put request to '/api/projects/{project id}/event definitions/{id}/' using the uuid and project id, provided you have 'event definition:write' authorization.
Update experiment detailsUpdate an experiment by sending a put request with `project id` and `id`, including new details as json/form data.
Update feature flag configurationManage feature flags for your app with creation, reading, updating, and deletion options.
Update organization details by uuidUpdate specific details of an organization using its uuid.
Update organization domain info and saml configUpdate a domain's info for a specific organization by id, including verification status and saml configuration.
Update organization domain propertiesUpdates selected properties of a domain in an organization via patch request, supports various data formats but saml fields are immutable.
Update organization member by uuidsPatch '/api/organizations/{id}/members/{uuid}': updates org member with user and org uuids.
Update organization member detailsUpdate member details in an organization by id and user uuid.
Update organization s proxy record domainUpdate a proxy record's domain details for a specified organization and proxy record id using put.
Update partial project cohort detailsUpdate partial cohort details for a specific project.
Update partial role details in organizationPatch /api/organizations/{organization id}/roles/{id}/: update partial details of a role by id within an organization, including name and feature flag access level.
Update partial subscription detailsPatch /api/projects/{project id}/subscriptions/{id}/: update partial details of a specific project subscription by id.
Update partial survey detailsUpdate partial survey details by patch to /api/projects/{project id}/surveys/{id}/ with uuid.
Update person propertiesRequest data's "properties" will be updated on a person using "$set" event, affecting only listed properties without deletion or other changes.
Update person property endpointThis endpoint allows for reading and deleting individuals.
Update pipeline destination configUpdate the configuration for a pipeline destination in a project.
Update pipeline frontend app configUpdate configuration for a specific pipeline frontend app by providing its id and the project id.
Update pipeline plugin configUpdate a project-specific pipeline plugin configuration by supplying the project id and config id.
Update pipeline transformation configUpdate a pipeline transformation configuration for a specific project and config id.
Update plugin config for projectUpdate a plugin config's partial details in a project by its id using patch.
Update project action by idPut endpoint '/api/projects/{project id}/actions/{id}/' updates actions in a project by id, accepts json/form data, supports 'format' query, and needs 'action:write' authentication.
Update project action with partial dataUpdate an action within a project with a specified id.
Update project cohort detailsUpdate cohort details of a specific project by id.
Update project dashboard detailsEndpoint to update an existing dashboard within a project.
Update project early access featureUpdate a specific early access feature of a project by providing the `project id` and feature `id` (uuid).
Update project event definitionUpdate an existing event definition for a specified project using its uuid.
Update project group type metadataPatch /api/projects/{project id}/groups types/update metadata: update group type metadata for a specific project using its project id.
Update project insight detailsEndpoint "/api/projects/{project id}/insights/{id}/" allows for updating an insight's details for a given project and insight id, supporting json and csv formats, with fields like name, query, and various timestamps.
Update project member role by uuidUpdate a project member's role using their uuid in a specific project.
Update project member s role by uuidUpdate explicit project membership using uuids.
Update project notebook detailsThe api for interacting with notebooks.
Update project pipeline destination configUpdate a project's pipeline destination config by id via patch api request.
Update project pipeline transformation configUpdate a specific pipeline transformation configuration for a project by providing a `project id` and configuration `id`.
Update project plugin configurationUpdate project plugin config using its integer id and project string id; accepts json, url-encoded, or form-data.
Update project property definitionUpdate a property definition in a project by its uuid.
Update project session recording playlistUpdate an existing session recording playlist for a project with the specified project id and playlist short id.
Update project subscription detailsUpdate a subscription for a specific project.
Update project survey detailsThe `/api/projects/{project id}/surveys/{id}/` put endpoint updates survey details in a project using survey uuid and project id, accepts json/form/multipart data, needs `survey:write` permission, and returns the updated survey.
Update role details in organizationUpdate an organization role by submitting its uuid and organization id in uuid format.
Update session recording playlist partiallyUpdate session recording playlists using patch on the endpoint with `project id` and `short id`.
Update specific proxy record fieldsPatch `/api/organizations/{organization id}/proxy records/{id}/`: update specific fields of a proxy record by id within an organization.

Why Use Composio?

AI Native Posthog Integration

  • Supports both Posthog MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying your Posthog data

Managed Auth

  • Built-in API key handling and secure credential storage
  • Central place to manage, scope, and revoke Posthog access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Posthog
  • Scoped, least privilege access to Posthog resources
  • Full audit trail of agent actions to support review and compliance

Connect Posthog MCP Tool with your Agent

Python
TypeScript

Install Composio

python
pip install composio claude-agent-sdk
Install the Composio SDK and Claude Agent SDK

Create Tool Router Session

python
from composio import Composio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions

composio = Composio(api_key='your-composio-api-key')
session = composio.create(user_id='your-user-id')
url = session.mcp.url
Initialize the Composio client and create a Tool Router session

Connect to AI Agent

python
import asyncio

options = ClaudeAgentOptions(
    permission_mode='bypassPermissions',
    mcp_servers={
        'tool_router': {
            'type': 'http',
            'url': url,
            'headers': {
                'x-api-key': 'your-composio-api-key'
            }
        }
    },
    system_prompt='You are a helpful assistant with access to Posthog tools.',
    max_turns=10
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query('List all dashboards for project 12345')
        async for message in client.receive_response():
            if hasattr(message, 'content'):
                for block in message.content:
                    if hasattr(block, 'text'):
                        print(block.text)

asyncio.run(main())
Use the MCP server with your AI agent

Connect Posthog API Tool with your Agent

Python
TypeScript

Install Composio

python
pip install composio_openai
Install the Composio SDK

Initialize Composio and Create Tool Router Session

python
from openai import OpenAI
from composio import Composio
from composio_openai import OpenAIResponsesProvider

composio = Composio(provider=OpenAIResponsesProvider())
openai = OpenAI()
session = composio.create(user_id='your-user-id')
Import and initialize Composio client, then create a Tool Router session

Execute Posthog Tools via Tool Router with Your Agent

python
tools = session.tools
response = openai.responses.create(
  model='gpt-4.1',
  tools=tools,
  input=[{
    'role': 'user',
    'content': 'Add a collaborator to my analytics dashboard with view access'
  }]
)
result = composio.provider.handle_tool_calls(
  response=response,
  user_id='your-user-id'
)
print(result)
Get tools from Tool Router session and execute Posthog actions with your Agent

Use Posthog with any AI Agent Framework

Choose a Framework you want to connect Posthog with

OpenAI Agents SDK

OpenAI Agents SDK

Use Posthog MCP with OpenAI Agents SDK

Claude Agents SDK

Claude Agents SDK

Use Posthog MCP with Claude Agents SDK

Google ADK

Google ADK

Use Posthog MCP with Google ADK

Langchain

Langchain

Use Posthog MCP with Langchain

AI SDK

AI SDK

Use Posthog MCP with AI SDK

Mastra AI

Mastra AI

Use Posthog MCP with Mastra AI

LlamaIndex

LlamaIndex

Use Posthog MCP with LlamaIndex

CrewAI

CrewAI

Use Posthog MCP with CrewAI

Pydantic AI

Pydantic AI

Use Posthog MCP with Pydantic AI

Autogen

Autogen

Use Posthog MCP with Autogen

Frequently Asked Questions

Do I need my own developer credentials to use Posthog with Composio?

Yes, Posthog requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

Can I use multiple toolkits together?

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Is Composio secure?

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

What if the API changes?

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Used by agents from

Context
ASU
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
ASU
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
ASU
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai

Never worry about agent reliability

We handle tool reliability, observability, and security so you never have to second-guess an agent action.

Book a call↗Get started for free