--- title: PostHog API Integration on Truto slug: posthog category: Analytics canonical: "https://truto.one/integrations/detail/posthog/" --- # PostHog API Integration on Truto **Category:** Analytics **Status:** Generally available ## Unified APIs ### Unified User Directory API - **Organizations** — Organizations are the top level entity in the source application. Users are associated with an organization. - **Users** — The User object represents a User. ## How it works 1. **Link your customer's PostHog account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach PostHog.** The Proxy API is a 1-to-1 mapping of the PostHog API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Sync PostHog persons and groups into your product's user directory** — If you're building a CRM, customer success platform, or revenue tool, you can pull PostHog's Persons (users) and Groups (organizations) into your product so your customers see real account structures alongside product usage context — without building a custom PostHog integration from scratch. - **Enrich support workflows with PostHog user context** — Helpdesk and support platforms can map their user records to PostHog Persons, giving agents instant visibility into who the user is, which organization they belong to, and their associated properties — all surfaced natively in the support UI. - **Power account-level health scoring with organization data** — Customer success and revenue intelligence platforms can pull PostHog Group (organization) data to build product health scores, identify at-risk accounts, and give account executives real context about how a company is using the product. - **Build AI-powered copilots with user and org awareness** — AI agent platforms and copilot products can query PostHog user and organization data to ground their responses in real context — knowing who the user is, what organization they belong to, and their properties before generating recommendations or troubleshooting steps. - **Automate user and organization provisioning across tools** — Workflow automation and iPaaS products can sync PostHog's user and organization directory with other systems, ensuring that when a new person or group appears in PostHog, downstream tools stay in sync without manual intervention. ## What you can build - **Account directory sync from PostHog Groups** — Automatically import PostHog Groups (organizations) into your platform so customers see their real account hierarchy without manual CSV uploads. - **User identity resolution panel** — Surface PostHog Person properties — like email, name, and custom traits — directly inside your product's user detail view, giving your customers a unified profile. - **Organization-aware feature gating** — Pull PostHog Group properties (e.g., subscription tier, plan type) into your platform to drive access controls, entitlements, or tiered feature visibility for end users. - **Cross-platform user directory search** — Let your customers search and browse PostHog Persons and Groups alongside users from other connected tools using Truto's Unified User Directory API. - **Account context cards for sales and support** — Display a compact PostHog organization card — showing group properties and associated users — inside CRM deal views or support ticket sidebars. ## FAQs ### What Truto Unified APIs are available for PostHog? PostHog is supported through Truto's Unified User Directory API, which provides standardized access to Organizations (mapped from PostHog Groups) and Users (mapped from PostHog Persons). Additional tools and API resources can be built on request. ### How does authentication work for PostHog integrations via Truto? PostHog's API uses personal API keys or project API keys for authentication. Truto handles credential storage and auth management so your end users can connect their PostHog accounts securely without you building a custom auth flow. ### Does PostHog have rate limits that affect integration performance? Yes, PostHog enforces rate limits on its API endpoints. Truto manages pagination and request throttling automatically, so your integration handles large datasets without hitting limits or requiring manual retry logic. ### Can I access custom properties on PostHog Persons and Groups? PostHog allows arbitrary custom properties on both Persons and Groups. Truto's Unified User Directory API maps standard fields, and custom properties can be accessed as additional data. If you need specific custom field mappings, Truto can build tailored support on request. ### What if I need PostHog data beyond users and organizations — like events, session replays, or feature flags? Currently, the Unified User Directory API covers Organizations and Users. PostHog's API also exposes events, session recordings, feature flags, insights, and more. Truto can build custom tools for these endpoints on request to match your specific integration needs. ### Does Truto support both PostHog Cloud and self-hosted instances? PostHog can be deployed as a cloud service (us.posthog.com / eu.posthog.com) or self-hosted. Truto can be configured to point at your end users' specific PostHog instance URL, supporting both deployment models.