# Heap

> Analyze user behavior via the Heap API, including tracking events, adding user properties, and querying events.

- Skill: `kbarbel640-del/heap` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add kbarbel640-del/heap`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kbarbel640-del/heap/raw
- Safety review: CAUTION (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs, Data & Analytics, Data Analysis, SaaS Connectors
- Tags: Api Integration, Events, Funnels, Heap, Product Analytics, Users
- Author: kbarbel640-del (https://skillmd.com/u/kbarbel640-del)
- Updated: 2026-08-22
- Page: https://skillmd.com/skills/kbarbel640-del/heap

---

# Heap
Product analytics.
## Environment
```bash
export HEAP_APP_ID="xxxxxxxxxx"
export HEAP_API_KEY="xxxxxxxxxx"
```
## Track Event (Server-side)
```bash
curl -X POST "https://heapanalytics.com/api/track" \
  -H "Content-Type: application/json" \
  -d '{"app_id": "'$HEAP_APP_ID'", "identity": "user@example.com", "event": "Purchase", "properties": {"amount": 99}}'
```
## Add User Properties
```bash
curl -X POST "https://heapanalytics.com/api/add_user_properties" \
  -H "Content-Type: application/json" \
  -d '{"app_id": "'$HEAP_APP_ID'", "identity": "user@example.com", "properties": {"plan": "premium"}}'
```
## Query API
```bash
curl "https://heapanalytics.com/api/partner/v1/events?app_id=$HEAP_APP_ID" \
  -H "Authorization: Bearer $HEAP_API_KEY"
```
## Links
- Dashboard: https://heapanalytics.com
- Docs: https://developers.heap.io