Event API

https://event.convertmax.io is the Convertmax event ingestion API. Use it to send analytics and behavioral events from your site, app, or server.

This API is separate from the official Convertmax API on api.convertmax.io, which handles platform product, contact, and order data.

For supported event names and payload shapes, see Event Tracking. For Segment-compatible ingestion, see Segment Compatibility.

API Endpoints

GET /

• Auth: Not required (public)
• Purpose: Health/welcome response
• Response: JSON welcome message

Example:

curl -X GET https://event.convertmax.io/

POST /v1/track/

• Auth: Required
• Auth options:
  • Authorization: Bearer <api_key>
  • ?key=<api_key> query parameter
• Purpose: Ingest tracking events
• Response: Empty JSON object {} on success

Example using Authorization header:

curl -X POST https://event.convertmax.io/v1/track/ \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "event_type": "page_view",
    "visitor": "visitor_123",
    "session_id": "session_abc",
    "data": {
      "page": "https://example.com"
    }
  }'

Example using ?key=:

curl -X POST "https://event.convertmax.io/v1/track/?key=<api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "event_type": "convert",
    "visitor": "visitor_123",
    "session_id": "session_abc",
    "data": {
      "page": "https://example.com/checkout/success"
    }
  }'

Related reference

• Convertmax API — platform read/write APIs on api.convertmax.io
• Event Tracking — supported event names, payload expectations, and examples
• Segment Compatibility — send Segment-style payloads with endpoint and mapping details
• Webhooks — HTTP webhooks from external systems (separate from POST /v1/track/)