API product analytics installation

  1. Send events via the API

    Required

    You can send events directly to the PostHog API from any programming language or platform that can make HTTP requests:

    HTTP
    POST https://us.i.posthog.com/capture/
    Content-Type: application/json
    

    {
        "api_key": "<ph_project_api_key>",
        "event": "[event name]",
        "properties": {
            "distinct_id": "[your users' distinct id]",
            "key1": "value1",
            "key2": "value2"
        },
        "timestamp": "[optional timestamp in ISO 8601 format]"
    }

  2. Person profiles

    Optional

    By default, events are sent with person profile processing enabled. To disable this for specific events, add the following property:

    JSON
    {
        "api_key": "<ph_project_api_key>",
        "event": "page_viewed",
        "properties": {
            "distinct_id": "user_123",
            "$process_person_profile": false
        }
    }
    Learn more

    Read more about person profiles in our documentation.

  3. Next steps

    Recommended
    ResourceDescription
    Capturing eventsLearn how to capture custom events beyond autocapture
    Identifying usersAssociate events with specific users
    Creating insightsBuild trends, funnels, and retention charts
    Group analyticsTrack events at the company or account level

Community questions

Was this page useful?

Questions about this page? or post a community question.