API Reference - Lead Submission

URL: https://admin.pulse.bpcorp.eu/api/leads/submit Method: POST

Headers

Header	Required	Description
Content-Type	Yes	Must be application/json
X-Source-API-Key	Yes	The UUID key of the target Vertical.

Payload Schema

The payload is flexible (JSON schema-less), but standard fields are recommended for better routing.

{
  "email": "john@example.com",       // Required for most flows
  "phone": "0612345678",             // Recommended for SMS/Call
  "first_name": "John",
  "last_name": "Doe",
  "channel": "facebook",             // Critical for Campaign Mapping
  "custom_data": {                   // Any nested data is preserved
    "budget": "10k",
    "project_type": "renovation"
  }
}

Responses

200 OK

Lead accepted and queued for distribution.

{
  "success": true,
  "lead_id": "550e8400-e29b-41d4-a716-446655440000",
  "vertical": "Life Insurance",
  "campaign": "Life Insurance - Facebook"
}

400 Bad Request

Validation failed or Spam detected.

{
  "success": false,
  "error": "Lead rejected: spam detected",
  "reason": "Duplicate lead (24h)"
}

401 Unauthorized

Invalid API Key.

{
  "error": "Invalid API Key or inactive vertical"
}