---
title: "Record Landing Event"
method: POST
path: "/api/v1/landing/events"
---

# Record Landing Event

`POST /api/v1/landing/events`

## Request

- Base URL: `https://app.heyjarvie.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.heyjarvie.com/api/v1/landing/events`
- Auth: none declared

Store one landing event. Fields that fail cleaning are dropped.

## Headers

- `authorization` string, nullable

## Request body

- LandingEventRequest: One event. Only ``event_type`` is required; the rest depends on the step.
  - `event_type` 'visit' | 'handoff' | 'tap' | 'opened' | 'closed' | 'not_opened', required
  - `vid` unknown
  - `cid` unknown
  - `path` unknown
  - `utm_source` unknown
  - `utm_medium` unknown
  - `utm_campaign` unknown
  - `utm_term` unknown
  - `utm_content` unknown
  - `click_id_param` unknown
  - `entry` unknown
  - `device` unknown
  - `via` unknown
  - `outcome` unknown
  - `line` unknown

## Response `204`

Successful Response

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/heyjarvie/apis/jarvis-api.md) - [All operations](https://skmtc.dev/heyjarvie/apis/jarvis-api/llms.txt) - [OpenAPI document](https://skmtc.dev/heyjarvie/apis/jarvis-api/revisions/36fe7e94e33a?raw)