Algolia Insights API event and user-token contracts.
Scope
Primary execution surface: server.
Developer Source Map
RudderStack Cross-Check
RudderStack is used here only as secondary engineering evidence for discovery and cross-check.
| Destination | Type | Link |
|---|
algolia | Discovery lead | source |
Verified Contracts
Event Contracts
| Object / Event | Field | Applies To | Type | Requirement | Exact Format | Normalization | Hashing | Examples | Caveat | Primary Source | Status | Confidence |
|---|
event | event_contract | server | object | Conditional | POST /1/events with events[].eventType, events[].eventName, events[].index, and events[].userToken. | Not clearly specified | Not clearly specified | - | Verified against vendor-owned developer documentation for this contract category. | www.algolia.com | Verified | High |
User Data Contracts
| Object / Event | Field | Applies To | Type | Requirement | Exact Format | Normalization | Hashing | Examples | Caveat | Primary Source | Status | Confidence |
|---|
user | user_data_contract | server | object | Conditional | Platform user/profile identifier contract surface is documented on the referenced developer page. | Not clearly specified | Not clearly specified | - | Verified against vendor-owned developer documentation for this contract category. | www.algolia.com | Verified | High |
Transport / Payload Rules
| Object / Event | Field | Applies To | Type | Requirement | Exact Format | Normalization | Hashing | Examples | Caveat | Primary Source | Status | Confidence |
|---|
request | endpoint | server | object | Required | HTTPS endpoint https://insights.algolia.io/1/events with X-Algolia-Application-Id and X-Algolia-API-Key. | Not clearly specified | Not clearly specified | - | Verified against vendor-owned developer documentation for this contract category. | www.algolia.com | Verified | High |
Candidate / Needs Review Items
Normalization Rules
| Object / Event | Field | Applies To | Type | Requirement | Exact Format | Normalization | Hashing | Examples | Caveat | Primary Source | Status | Confidence |
|---|
normalization | normalization_contract | server | string | Optional | Not clearly specified in one canonical row-level contract; see blocker/caveat. | Not clearly specified | Not clearly specified | - | Blocker: normalization_contract_missing — Rudder-specific guards (timestamp/queryID constraints) are implementation behavior, not full vendor contract. | www.algolia.com | Needs manual review | Medium |
Excluded Items
| Object / Event | Field | Caveat | Primary Source | Status | Confidence |
|---|
normalization | hashing_contract | Excluded: row_definition_missing — Investigated, but not supportable strongly enough for verified publication. | www.algolia.com | Excluded | Low |
Last Reviewed
2026-03-31