PostHog Hello World
Overview
Minimal working example demonstrating core PostHog functionality.
Prerequisites
-
Completed posthog-install-auth setup
-
Valid API credentials configured
-
Development environment ready
Instructions
Step 1: Create Entry File
Create a new file for your hello world example.
Step 2: Import and Initialize Client
import { PostHogClient } from '@posthog/sdk';
const client = new PostHogClient({ apiKey: process.env.POSTHOG_API_KEY, });
Step 3: Make Your First API Call
async function main() { // Your first API call here }
main().catch(console.error);
Output
-
Working code file with PostHog client initialization
-
Successful API response confirming connection
-
Console output showing:
Success! Your PostHog connection is working.
Error Handling
Error Cause Solution
Import Error SDK not installed Verify with npm list or pip show
Auth Error Invalid credentials Check environment variable is set
Timeout Network issues Increase timeout or check connectivity
Rate Limit Too many requests Wait and retry with exponential backoff
Examples
TypeScript Example
import { PostHogClient } from '@posthog/sdk';
const client = new PostHogClient({ apiKey: process.env.POSTHOG_API_KEY, });
async function main() { // Your first API call here }
main().catch(console.error);
Python Example
from posthog import PostHogClient
client = PostHogClient()
Your first API call here
Resources
-
PostHog Getting Started
-
PostHog API Reference
-
PostHog Examples
Next Steps
Proceed to posthog-local-dev-loop for development workflow setup.