Skip to main content
POST
/
api
/
v1
/
insights
/
conversions
Error
A valid request URL is required to generate request examples
{
  "deduped": true,
  "completion_id": "01935-cccc-…"
}

Authorizations

Authorization
string
header
required

Deploy-wide server-to-server bearer token (ENGINE_API_TOKEN), validated by the engine_api firewall. Authenticates the Engine API, Knowledge base, and Conversions surfaces. The tenant_id rides in the request body and is trusted in V1 — keep this token strictly server-side.

Body

application/json
tenant_id
string<uuid>
required
goal
string
required

Code of the tenant goal this conversion fulfils.

conversation_id
string<uuid> | null

Attach for conversation attribution.

external_ref
string | null

Reference carried through your funnel (e.g. order id) for attribution/dedupe.

occurred_at
string<date-time> | null

When the conversion happened; defaults to now.

props
object

Free-form payload, e.g. value + currency.

Response

Duplicate — this conversion was already recorded.

deduped
enum<boolean>
required
Available options:
true
completion_id
string
required

Id of the original (already-recorded) completion.