Lead Import API Guide

Overview

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

Use your personal Lead Import API Key to ensure leads are imported and get added to your account.

Authentication

• Requires User's Lead Import API Key (find in User Profile)

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 API Key
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
}