PostHog (Capture API)

🚀 Quickstart

Connect to PostHog’s Capture API with Nango and send your first event in 2 minutes. This uses a Project Token (phc_...), not a personal API key — the capture API is a public, write-only endpoint with no identity validation, so no user login is required.

Create an integration

In Nango (free signup), go to Integrations -> Configure New Integration -> PostHog (Capture API).

Authorize PostHog

Go to Connections -> Add Test Connection -> Authorize, then enter your Hostname (e.g. us.i.posthog.com) and Project Token. Later, you’ll let your users do the same directly from your app.

Send your first event

Let’s send a test event via the capture API. Replace the placeholders below with your Environment API key, integration ID, and connection ID:

cURL
Node

curl "https://api.nango.dev/proxy/i/v0/e/" \
  -X POST \
  -H "Authorization: Bearer <NANGO-API-KEY>" \
  -H "Provider-Config-Key: <INTEGRATION-ID>" \
  -H "Connection-Id: <CONNECTION-ID>" \
  -H "Content-Type: application/json" \
  -d '{"event": "test-event", "distinct_id": "test-user-123"}'

Install Nango’s backend SDK with npm i @nangohq/node. Then run:

import { Nango } from '@nangohq/node';

const nango = new Nango({ apiKey: '<NANGO-API-KEY>' });

const res = await nango.post({
    endpoint: '/i/v0/e/',
    data: { event: 'test-event', distinct_id: 'test-user-123' },
    providerConfigKey: '<INTEGRATION-ID>',
    connectionId: '<CONNECTION-ID>'
});

console.log(res.data);

Nango automatically adds your stored Project Token as the api_key field in the request body — you only need to supply event and distinct_id (plus any properties you want).✅ You’re connected! Check the Logs tab in Nango to inspect requests.

Implement Nango in your app

Follow our Auth implementation guide to integrate Nango in your app.