---
title: "Ingest order event for activity matching"
method: POST
path: "/api/v1/lens/revenue-webhook"
tags: ["Diagnostics"]
---

# Ingest order event for activity matching

`POST /api/v1/lens/revenue-webhook`

## Request

- Base URL: `https://agenticcom.ai`
- URL: `https://agenticcom.ai/api/v1/lens/revenue-webhook`
- Auth: none declared

Record a bounded order event for later matching with observed monitoring activity. A match does not prove that a recorded visit caused the order or revenue.

## Request body

- LensRevenueWebhookRequest: Stable compatibility schema for order events used in activity matching; it does not establish causal attribution.
  - `site_id` string, required
  - `order_id` string, required
  - `currency` string, required
  - `amount_cents` integer, required
  - `items_count` integer
  - `session_id` string
  - `referrer` string

## Response `201`

Order event recorded for activity matching.

- LensRevenueWebhookResponse: Stable compatibility response. Any attribution_type value is a matching label, not proof of commercial causation.
  - `ok` boolean
  - `site_id` string
  - `order_id` string
  - `attribution_type` 'direct' | 'assisted' | 'influenced'
  - `matched_session_id` string, nullable

## Other responses

- `400`: Invalid payload.
- `404`: Site not found.
- `500`: Revenue event storage failed.

---

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