Conversions API Documentation

Track and measure conversion events across your e-commerce platform.

API Secret Required

All API requests require the X-Conversion-Secret header with your secret key.

Your API secret is: EAASlEvNg6jMBRRukG8EQmmvstnGzCALFR4NfMuoNfLk1p747SoYUYatZBq3NGXv6aGxqXaLayCZA91mxJONuzIAuse9YD7DbdZAlxgYlUzaLorZCRkBRFMEcYtcshaN6FnHbNiEzlGZCyB5Wdzmd1KJ6UxyE0ERdK6ZBSTrhQMQnCyM9tKP6txlze8ZCqXW5AZDZD

API Endpoints

POST /api/v1/conversions

Track a single conversion event.

{
  "event_name": "purchase",
  "user_id": 123,
  "email": "user@example.com",
  "order_id": "ORD-001",
  "revenue": 99.99,
  "currency": "USD",
  "custom_data": {
    "utm_source": "google",
    "utm_medium": "cpc"
  }
}

POST /api/v1/conversions/bulk

Track multiple conversion events in a single request.

{
  "events": [
    {
      "event_name": "purchase",
      "user_id": 123,
      "order_id": "ORD-001",
      "revenue": 99.99
    },
    {
      "event_name": "signup",
      "email": "user@example.com"
    }
  ]
}

Request Headers

Header Description Required
X-Conversion-Secret Your API secret key from .env file Yes
Content-Type application/json Yes

Response Format

All responses follow this format:

{
  "success": true,
  "message": "Conversion event recorded successfully",
  "data": { ... }
}
Back to Home