---
title: "Page view"
method: POST
path: "/v1/events/pageview"
tags: ["Settings"]
---

# Page view

`POST /v1/events/pageview`

## Request

- Base URL: `https://api.vicem.ai`
- URL: `https://api.vicem.ai/v1/events/pageview`
- Auth: none required

## Request body

- PageViewReq
  - `path` string, required
  - `ref` 'direct' | 'referral' | 'profile' | 'other'
  - `refHost` string
  - `utmSource` string
  - `paid` 'google' | 'microsoft' | 'meta' | 'other'

## Response `200`

OK. The body is not part of the contract (usually `{"ok": true}`).

- object

## Other responses

- `400`: Invalid request (body not JSON, or schema validation failed).
- `413`: Body over the limit (64 KB; 512 KB for contact import).
- `429`: Too many requests from this caller; wait and try again.
- `500`: Unexpected server error (reported to Sentry).

---

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