@practicestack/leads

Lightweight JavaScript SDK to capture leads from any website and push them directly into your PracticeStacks account. Zero dependencies, works everywhere — React, Next.js, Vue, vanilla HTML, or any website.

Quick Start

1. Get Your API Token

Go to PracticeStacks > Settings > API Tokens > Create Token with LEADS_WRITE scope.

2. Install

npm / bun / yarn:

npm i @practicestack/leads

CDN (no build tool needed):

<script src="https://cdn.jsdelivr.net/npm/@practicestack/leads/dist/index.global.js"></script>

3. Capture Leads

ES Modules (React, Next.js, Vue, etc.):

import PracticeStack from '@practicestack/leads';

PracticeStack.init({ token: 'ps_live_xxxxx' });

const result = await PracticeStack.captureLead({
  name: 'John Doe',
  email: 'john@example.com',
  phone: '9876543210',
  source: 'Website Contact Form',
});

if (result.success) {
  console.log('Lead captured:', result.lead.id);
} else {
  console.error('Error:', result.error);
}

Script tag (any HTML website):

<script src="https://cdn.jsdelivr.net/npm/@practicestack/leads/dist/index.global.js"></script>
<script>
  PracticeStack.init({ token: 'ps_live_xxxxx' });

  document.getElementById('contactForm').addEventListener('submit', async function (e) {
    e.preventDefault();

    const result = await PracticeStack.captureLead({
      name: document.getElementById('name').value,
      email: document.getElementById('email').value,
      phone: document.getElementById('phone').value,
      source: 'Website Contact Form',
    });

    if (result.success) {
      alert('Thank you! We will get back to you soon.');
    }
  });
</script>

API Reference

`PracticeStack.init(config)`

Initialize the SDK. Must be called before captureLead().

Parameter	Type	Required	Description
`token`	`string`	Yes	Your API token from PracticeStacks Settings
`baseUrl`	`string`	No	Override API URL (default: `https://app.practicestacks.com`)

`PracticeStack.captureLead(data)`

Capture a lead and push it to your PracticeStack account. Returns a Promise<CaptureResult>.

Parameter	Type	Required	Description
`name`	`string`	Yes	Lead/company name
`email`	`string`	No	Contact email address
`phone`	`string`	No	Contact phone number
`source`	`string`	No	Where the lead came from (default: `"Website"`)
`notes`	`string`	No	Additional notes or message from the form
`tags`	`string[]`	No	Tags for categorization (e.g., `["website", "urgent"]`)

Response:

// Success
{
  success: true,
  lead: {
    id: "clx...",
    companyName: "John Doe",
    companyEmail: "john@example.com",
    companyPhone: "9876543210",
    source: "Website Contact Form",
    status: "NEW",
    createdAt: "2026-03-20T..."
  }
}

// Error
{
  success: false,
  error: "Name is required"
}

`PracticeStack.reset()`

Reset the SDK configuration. Useful for testing or switching tokens.

Full Example: Contact Form

<!DOCTYPE html>
<html>
<head>
  <title>Contact Us</title>
</head>
<body>
  <h1>Contact Us</h1>
  <form id="contactForm">
    <input type="text" id="name" placeholder="Your Name" required />
    <input type="email" id="email" placeholder="Email" />
    <input type="tel" id="phone" placeholder="Phone" />
    <textarea id="message" placeholder="Your message"></textarea>
    <button type="submit">Send</button>
  </form>

  <script src="https://cdn.jsdelivr.net/npm/@practicestack/leads/dist/index.global.js"></script>
  <script>
    PracticeStack.init({ token: 'ps_live_xxxxx' });

    document.getElementById('contactForm').addEventListener('submit', async function (e) {
      e.preventDefault();
      var btn = this.querySelector('button');
      btn.disabled = true;
      btn.textContent = 'Sending...';

      var result = await PracticeStack.captureLead({
        name: document.getElementById('name').value,
        email: document.getElementById('email').value,
        phone: document.getElementById('phone').value,
        notes: document.getElementById('message').value,
        source: 'Website Contact Form',
      });

      if (result.success) {
        btn.textContent = 'Sent!';
        this.reset();
      } else {
        btn.textContent = 'Send';
        btn.disabled = false;
        alert('Something went wrong. Please try again.');
      }
    });
  </script>
</body>
</html>

Error Handling

Error	Cause
`"PracticeStack SDK not initialized..."`	Forgot to call `PracticeStack.init()`
`"Name is required"`	`name` field is empty
`"Invalid API token"`	Token is wrong or doesn't exist
`"API token has been revoked"`	Token was revoked in PracticeStacks settings
`"API token has expired"`	Token has passed its expiry date
`"API token does not have LEADS_WRITE permission"`	Token is missing the `LEADS_WRITE` scope

Requirements

A PracticeStacks account
An API token with LEADS_WRITE scope

License

MIT