S2S Conversion API¶

Endpoint¶

POST https://events.thrad.ai/v1/api/conversion

Headers¶

Required:

Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

Recommended:

Idempotency-Key: <unique_operation_key>

Request body¶

Required fields:

click_id (string)
conversion_time (ISO-8601 datetime)
conversion_value (number)
currency (3-letter ISO)

Optional fields:

event_type (defaults to purchase_completed)
order_id
event_id
page_url
referrer
user_agent
channel (defaults to server)
session_id
client_id
tag_id

Additional top-level fields are accepted and stored under params.extra.

Responses¶

Success:

{ "status": "ok" }

Duplicate:

{ "status": "duplicate" }

Dedupe and idempotency¶

First key: Idempotency-Key header (or event_id if header missing)
Additional dedupe via order_id for same click/event type
Reuse the same idempotency key for retries of the same conversion

Example¶

curl -X POST "https://events.thrad.ai/v1/api/conversion" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-123" \
  -d '{
    "click_id": "11111111-1111-4111-8111-111111111111",
    "conversion_time": "2026-02-19T18:00:00Z",
    "conversion_value": 49.99,
    "currency": "USD",
    "order_id": "order-123",
    "event_type": "purchase_completed"
  }'