Build powerful integrations.

curl -X POST https://api.dealoracle.io/v1/events \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event_name": "Lead", "email": "[email protected]"}'

{
  "user_data": {
    "email": "[email protected]",   // Required: email and/or phone
    "phone": "+1 252 531 2453"
  },
  "custom_data": {
    "value": 240,                      // Order amount
    "order_id": "RC-10482"             // Your order id - the dedupe key
  }
}

// event_name defaults to Purchase, event_time defaults to now.
// client_id is REQUIRED if your key owns more than one client account. Optional: event_name, event_time,
// event_source_url, address fields, any click IDs you already hold
// (yours always win), and test_mode: true to validate without sending.

{
  "ok": true,
  "duplicate": false,
  "event_id": "srv:Purchase:RC-10482",
  "value": 240,
  "currency": "USD",
  "matched_visitor": true,
  "matched_by": "email",
  "enriched": ["fbc", "fbp", "client_ip_address", "client_user_agent"],
  "provided_by_you": ["gclid"],
  "lead_id": "8f3c...",
  "lead_created": false,
  "revenue_recorded": true,
  "dispatched": true,
  "delivery": { "status": "sent", "sent": 1, "held": 0, "failed": 0 }
}

// "enriched" is exactly what we added that your payload did not have.
// "delivery.status" says whether the event reached an ad platform:
// sent, duplicate_held, failed or not_sent (with a reason).
// Send the same order_id twice and the second call returns
// duplicate: true without sending anything, for 30 days.

{
  "event_name": "Lead",          // Required: Lead, Purchase, Subscribe, etc.
  "event_time": 1706400000,      // Optional: Unix timestamp (defaults to now)
  "email": "[email protected]",   // Required: User email (will be hashed)
  "phone": "+1234567890",        // Optional: User phone (will be hashed)
  "first_name": "John",          // Optional: First name (will be hashed)
  "last_name": "Doe",            // Optional: Last name (will be hashed)
  "fbc": "fb.1.1234.5678",       // Optional: Facebook Click ID
  "fbp": "fb.1.1234.5678",       // Optional: Facebook Browser ID
  "gclid": "CjwKCAjw...",        // Optional: Google Click ID
  "ttclid": "ttclid_123...",     // Optional: TikTok Click ID
  "value": 1500.00,              // Optional: Conversion value
  "currency": "USD",             // Optional: Currency code (default: USD)
  "client_ip": "192.168.1.1",    // Optional: User's IP address
  "user_agent": "Mozilla/5.0..." // Optional: User's browser agent
}

{
  "success": true,
  "event_id": "evt_abc123xyz",
  "platforms": {
    "facebook": { "status": "sent", "match_quality": 0.95 },
    "google": { "status": "sent", "match_quality": 0.92 },
    "tiktok": { "status": "skipped", "reason": "no_click_id" }
  }
}

{
  "events": [
    {
      "event_name": "Lead",
      "email": "[email protected]",
      "fbc": "fb.1.1234.5678"
    },
    {
      "event_name": "Purchase",
      "email": "[email protected]",
      "value": 299.00,
      "gclid": "CjwKCAjw..."
    }
  ]
}

{
  "event_id": "evt_abc123xyz",
  "event_name": "Lead",
  "created_at": "2024-01-15T10:30:00Z",
  "platforms": {
    "facebook": {
      "status": "delivered",
      "delivered_at": "2024-01-15T10:30:01Z",
      "match_quality": 0.95
    },
    "google": {
      "status": "delivered",
      "delivered_at": "2024-01-15T10:30:02Z"
    }
  }
}