Lead Import API Guide

Overview

The Lead Import API lets you send lead data directly to your Buying Buddy CRM database.

Authentication

• Requires User's Lead Import ID (find in User Profile)
• For Round Robin distribution, use admin User's Lead Import ID

API Endpoint

POST https://www.leadsandcontacts.com/clientapi/lead-import

Available Fields

See the Lead Import-API Field Reference for all available fields

Example Fields:

Field	Description
api_key	Your Lead Import ID
email	Lead's email address
fname	First name
lname	Last name
phone	Phone number
request_subject	Lead's inquiry subject
request_details	Detailed message
notes	Internal notes
campaign_id	Associated campaign
rating	Lead rating
buyer_status	Timeframe/Status
tags	Lead tags
welcome_email	Send welcome email (0/1)

Code Examples

PHP Example

$postFields = array(
    "api_key"         => $lead_import_id,
    "email"           => $email,
    "fname"           => $firstname,
    "lname"           => $lastname,
    "phone"           => $phone,
    "request_subject" => $request,
    "request_details" => $message,
    "notes"           => 'some notes',
    "campaign_id"     => $campaign,
    "rating"          => $lead_rating,
    "buyer_status"    => $timeframe,
    "tags"            => $tags,
    "welcome_email"   => "0"
);

$url = 'https://www.leadsandcontacts.com/clientapi/lead-import';
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $postFields);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
$response = curl_exec($ch);
curl_close($ch);

cURL Example

curl -X POST https://www.leadsandcontacts.com/clientapi/lead-import \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "your-lead-import-id",
    "email": "john@example.com",
    "fname": "John",
    "lname": "Smith",
    "phone": "555-0123",
    "request_subject": "Property Inquiry",
    "welcome_email": "0"
  }'

Response

Returns JSON:

{
    "success": true    // or false if request fails
}