conversions

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.

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.

post/api/v1/conversions

Request

  • Base URL: https://app.blueticked.com
  • URL: https://app.blueticked.com/api/v1/conversions
  • Auth: HTTP bearer

Request body

contact_emailstring email
value_centsnumber required
currencystring
occurred_atstring date-time
sourcestring
external_refstring

Example request

{
  "contact_email": "buyer@example.com",
  "value_cents": 45000,
  "currency": "ZAR",
  "occurred_at": "2026-07-16T20:00:00Z",
  "source": "shopify",
  "external_ref": "order-1001"
}

Response

Existing conversion returned for a deduplicated external_ref

deduplicatedboolean required
request_idstring required

Example 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
  },
  "request_id": "req_b2e3d610e10f1b07468721ee98f0e1d2"
}

Changes

No recorded changes to this operation across all 1 revision of this API.