---
title: "Telemetry Referral"
method: POST
path: "/api/v1/telemetry/referral"
tags: ["engajamento"]
---

# Telemetry Referral

`POST /api/v1/telemetry/referral`

## Request

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

Registra a origem da visita: o que a whitelist aceita vira `mcp_referral`
(CTA do MCP) ou `referral`, ATRIBUÍDO à conta quando há sessão. Nada aceito é
resposta, não erro — e diz por quê.

## Request body

- ReferralIn: Os `utm_*` da URL, CRUS — quem decide o que vale é a whitelist do núcleo (`logger.utm_limpo`), a mesma do app. Chave fora da lista é ignorada.
  - `utm_source` string, nullable
  - `utm_medium` string, nullable
  - `utm_campaign` string, nullable
  - `utm_term` string, nullable
  - `utm_content` string, nullable
  - `pagina` string: o caminho em que a visita chegou

## Response `200`

Successful Response

- ReferralOut
  - `registrado` boolean, required
  - `evento` string, nullable: mcp_referral · referral
  - `utm` object: o que a whitelist aceitou
  - `motivo` string, nullable: por que nada foi registrado

## Other responses

- `422`: Validation Error
- `429`: teto de registros de origem

---

[API](https://skmtc.dev/estudoseletricos/apis/arc-flash-platform-api.md) · [All operations](https://skmtc.dev/estudoseletricos/apis/arc-flash-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/estudoseletricos/apis/arc-flash-platform-api/revisions/5877d717cb1b?raw)