Conversions

1 endpoint, each with examples that open in the console prefilled.

POST/api/v1/conversionsconversions:writeTry in console

Record a conversion

Report a conversion (an order, booking or any success event). Blueticked attributes it to the contact's most recent email click (falling back to the most recent delivery) within a 7-day window, and rolls the value up on the campaign and reports surfaces.

Body parameters

contact_email	string
value_centsrequired	number
currency	string
occurred_at	string
source	string
external_ref	string

The JSON request body is limited to 32 KiB (32,768 bytes). A larger body answers 413 payload_too_large; invalid JSON answers 400 validation_failed.
Identify the contact with contact_id (UUID) or contact_email (matched case-insensitively). An unknown contact is stored UNATTRIBUTED and counted: never dropped, never an error.
value_cents is a non-negative integer in the currency's minor unit; currency is a 3-letter ISO code (default ZAR). Mixed-currency totals are always reported as a per-currency breakdown, never summed.
Attribution is last-touch: the most recent email CLICK in the 7 days before occurred_at, falling back to the most recent delivery. attributed: false means no email engagement fell inside the window.
external_ref makes ingestion idempotent: replaying the same reference returns the stored conversion (200) instead of double-counting.
Values are your own reported figures. Blueticked attributes them but never verifies them, and they are unrelated to Blueticked billing.

curl -X POST "https://app.blueticked.com/api/v1/conversions" \
  -H "Authorization: Bearer $BLUETICKED_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "contact_email": "buyer@example.com",
  "value_cents": 45000,
  "currency": "ZAR",
  "occurred_at": "2026-07-16T20:00:00Z",
  "source": "shopify",
  "external_ref": "order-1001"
}'

Response

{
  "conversion": {
    "id": "59c73d94-68e7-44fd-bbb5-2c7d94ffb2f1",
    "contact_id": "ff506e53-e2f0-4d92-884a-dab77d628bad",
    "campaign_id": "8701a57c-11df-4a63-a950-0f22206d6bdf",
    "message_id": "763c4dc3-d46b-4c10-8bd4-3f233a933ea0",
    "value_cents": 45000,
    "currency": "ZAR",
    "occurred_at": "2026-07-16T20:00:00.000Z",
    "source": "shopify",
    "external_ref": "order-1001",
    "attributed": true
  },
  "deduplicated": false,
  "request_id": "req_b2e3d610e10f1b07468721ee98f0e1d2"
}