---
title: "Record a privacy-safe acquisition milestone"
method: POST
path: "/analytics/events"
---

# Record a privacy-safe acquisition milestone

`POST /analytics/events`

## Request

- Base URL: `https://handover.sh/api/v1`
- URL: `https://handover.sh/api/v1/analytics/events`
- Auth: none required

Accepts an allowlisted event and limited campaign attribution. The service does not store IP addresses, user agents, search queries, handover metadata, or artifact content in acquisition analytics.

## Request body

- AcquisitionEventInput
  - `eventName` 'page_view' | 'engaged_view' | 'cta_clicked' | 'workspace_opened' | 'onboarding_viewed', required
  - `path` string
  - `pageKind` 'landing' | 'docs' | 'guide' | 'skill' | 'template' | 'tool' | 'install' | 'demo' | 'workspace' | 'other'
  - `source` string
  - `medium` string
  - `campaign` string
  - `referrer` string, uri

## Response `202`

Event accepted

- AcquisitionAcceptedEnvelope
  - `data` object, required
    - `accepted` true, required

## Other responses

- `400`: Request error

---

[API](https://skmtc.dev/handover/apis/handover-api.md) · [All operations](https://skmtc.dev/handover/apis/handover-api/llms.txt) · [OpenAPI document](https://skmtc.dev/handover/apis/handover-api/revisions/846b2a3091df?raw)