---
title: "Reporta una conversión web (Pixel) a Meta — espejo server-side con dedup por event_id"
method: POST
path: "/conversions/web"
tags: ["Conversions"]
---

# Reporta una conversión web (Pixel) a Meta — espejo server-side con dedup por event_id

`POST /conversions/web`

## Request

- Base URL: `https://api.met.meteor.com.co/api/v1`
- URL: `https://api.met.meteor.com.co/api/v1/conversions/web`
- Auth: one of:
  - `bearer` (a scheme the document does not define)
  - HTTP bearer

El espejo server-side del Pixel para conversiones web. Manda el mismo evento por servidor con la clave de deduplicación, para que Meta no lo cuente dos veces cuando el Pixel del navegador también lo reporta.

## Request body

- CreateWebConversionDto
  - `client_ip_address` string: IP del navegador del USUARIO FINAL (no la del servidor que reporta). El caller server-side la reenvía; mejora el match de Meta. Best-effort.
  - `client_user_agent` string: User-Agent del navegador del usuario final. El caller lo reenvía. Best-effort.
  - `currency` string
  - `email` string: Email en claro — se hashea SHA-256 antes de salir.
  - `event_id` string, required: El MISMO `eventID` que disparó el Pixel client-side. Clave del dedup.
  - `event_name` string, required: Nombre del evento web (debe estar en la taxonomía del workspace).
  - `event_source_url` string: URL donde ocurrió el evento (`event_source_url`).
  - `external_id` string: Id externo del cliente (order_id, user_id…) — se hashea SHA-256.
  - `fbc` string: Cookie `_fbc` del navegador (click de anuncio). No se hashea.
  - `fbp` string: Cookie `_fbp` del navegador (Pixel). No se hashea.
  - `gbraid` string: Identificador de clic para tráfico de app sujeto a privacidad.
  - `gclid` string: Identificador del clic de Google Ads. Se envía sin hash a Data Manager.
  - `phone` string: Teléfono en claro — se normaliza a dígitos y se hashea SHA-256.
  - `value` number
  - `wbraid` string: Identificador de clic para tráfico web sujeto a privacidad.

## Response `201`

- object: Sobre en el que viaja toda respuesta correcta de la API. El recurso está en `data`. Los SDKs oficiales lo desenvuelven por ti; un cliente hecho a mano tiene que leer `.data`.
  - `success` true, required: Siempre `true` en una respuesta 2xx.
  - `data` ConversionResultDto, required
    - `decision` 'accepted' | 'pending_corroboration' | 'discarded' | 'duplicate', required: Qué hizo la compuerta: - `accepted` — se emitió a Meta. - `pending_corroboration` — falta evidencia; queda esperando y se reevalúa. - `discarded` — no se emitió. `reason` dice por qué. - `duplicate` — ya se había emitido una igual (dedup por `event_id`).
    - `deliveryId` string: Entrega hacia Meta, cuando se emitió.
    - `eventId` string: `event_id` con el que viajó a Meta. Es la llave de deduplicación.
    - `eventRowId` string: Fila del libro de conversiones, para auditar después.
    - `reason` string: Por qué se descartó o quedó pendiente. Ausente cuando se aceptó.

## Other responses

- `400`: La request no es válida: un campo no pasa validación, falta un parámetro requerido o el recurso no admite la transición solicitada.
- `401`: API key ausente, inválida, revocada o expirada — o el workspace está bloqueado.
- `403`: La key está autenticada pero no puede ejecutar esta operación: scope faltante, capacidad deshabilitada, modo test restringido o recurso fuera de su cartera.
- `404`: El recurso no existe o no está disponible dentro del alcance de la key. No revela la existencia de recursos de otros tenants.
- `409`: La operación entra en conflicto con el estado actual o con un Idempotency-Key en uso. No reintentes con el mismo key y un body distinto.
- `429`: Se superó el límite por minuto de la key o la cuota del plan. Respeta `Retry-After`; el SDK ya reintenta solo.
- `500`: Error del servidor o del Met que ejecutaba. El SDK reintenta los 5xx con backoff.

---

[API](https://skmtc.dev/meteor/apis/met-public-api.md) · [All operations](https://skmtc.dev/meteor/apis/met-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/meteor/apis/met-public-api/revisions/fc6d3aad75de?raw)