Skip to content

OpenPanel is an open-source web and product analytics platform, an open-source alternative to Mixpanel with optional self-hosting.

1.2 KB
Raw Blame
---
title: Track
description: How to send events, identify users, and manage groups via the HTTP API.
---

## Good to know

- Pass the `x-client-ip` header to enable geo location tracking
- Pass the `user-agent` header to enable device detection

## Authentication

All requests require a `write` or `root` client. See the [Authentication](/docs/api/authentication) guide.

```bash
-H "openpanel-client-id: YOUR_CLIENT_ID" \
-H "openpanel-client-secret: YOUR_CLIENT_SECRET"
```

## Base URL

```
https://api.openpanel.dev
```

## Event types

The `/track` endpoint accepts a `type` field that determines what gets recorded:

| Type | Description |
|------|-------------|
| `track` | Record a named event with optional properties |
| `identify` | Create or update a user profile |
| `increment` | Increment a numeric profile property |
| `decrement` | Decrement a numeric profile property |
| `group` | Create or update a group |
| `assign_group` | Link a profile to one or more groups |

### Groups and events

Groups are never auto-populated on events — even after `assign_group`. Pass `groups` explicitly on each `track` call where you need group data.

For full request/response schemas for every event type, see the [API Reference](/docs/api-reference/track/postTrack).