Webhook Basics

CleverROI provides a simple webhook endpoint that accepts lead data, scores it, and returns the result. You can call it from any application that can send HTTP requests.

Endpoint URL

https://yourdomain.com/api/webhook.php

Replace yourdomain.com with your actual domain.

Authentication

You must include your API key in the request header. Find your API key in the CleverROI dashboard under Profile or Webhook Info.

X-API-KEY: your_api_key_here

Request Format

Send a POST request with a JSON body containing at least one of email or phone. All fields are optional but recommended for accurate scoring.

{
  "name": "John Doe",
  "email": "john@example.com",
  "phone": "+1234567890",
  "message": "I'm interested in your services",
  "budget": 50000,
  "source": "website"
}

Response

The API returns a JSON object with the scoring result:

{
  "success": true,
  "version": "2.0.0",
  "lead_id": "lead_123abc",
  "data": {
    "score": 85,
    "grade": "Hot",
    "priority_action": "Immediate call (within 1 hour)",
    "closing_probability": "High (70-90%)",
    "reasons": [...],
    "ai": {...},
    "contact_grade": "A"
  }
}

If the request is invalid or the plan limit is reached, you'll receive an error response.

Example cURL

curl -X POST https://yourdomain.com/api/webhook.php \
  -H "X-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Jane Smith",
    "email": "jane@company.com",
    "phone": "+1987654321",
    "budget": 100000,
    "source": "linkedin"
  }'