Leads API | Better Sales Pro API Docs

List and update leads through authenticated API methods.

curl --request POST \
  --url https://bettersalespro.com/admin/api/leads \
  --data 'token=YOUR_TOKEN'

const body = new URLSearchParams({ token: 'YOUR_TOKEN' });
const res = await fetch('https://bettersalespro.com/admin/api/leads', {
  method: 'POST',
  body
});
console.log(await res.json());

$ch = curl_init('https://bettersalespro.com/admin/api/leads');
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POSTFIELDS => http_build_query(['token' => 'YOUR_TOKEN']),
]);
echo curl_exec($ch);

Overview

Lead methods live on the partner API controller and require a valid staff token.

List leads

POST/admin/api/leads

Returns leads available to the authenticated account.

tokenstringrequired

Staff API token from login.

Update lead

POST/admin/api/updateLead

Updates an existing lead for the authenticated staff context.

Parameters

In addition to token, update methods accept lead fields posted by the client application. Always validate field names against your account configuration and CRM custom fields.

Errors

Missing/invalid token → session_expired
Permission failures → access denied responses on protected methods