Dashboard

Quick Start Guide

Get up and running with the Lead Management API in under 5 minutes

Start here
5 min read

Before You Start

You'll need an API key from your workspace settings

Basic knowledge of REST APIs and HTTP requests

A tool like curl, Postman, or your preferred programming language

1

API Base URL

All API requests are made to this base URL

Production URL

https://your-domain.com/api/v1

Note: All endpoints are versioned with /v1 prefix.

2

Authentication

Include your API key in the Authorization header

Bearer Token Format

Authorization: Bearer sk-workspace_your_api_key_here

Security: Keep your API key secure! Never expose it in client-side code or public repositories.

3

Make Your First Request

Test your setup by fetching leads

Using cURL

curl -X GET "https://your-domain.com/api/v1/leads" \
  -H "Authorization: Bearer sk-workspace_your_api_key_here" \
  -H "Content-Type: application/json"

Using JavaScript

const response = await fetch('https://your-domain.com/api/v1/leads', {
  headers: {
    'Authorization': 'Bearer sk-workspace_your_api_key_here',
    'Content-Type': 'application/json'
  }
});

const data = await response.json(); 

Expected Response

{
  "success": true,
  "data": [
    {
      "id": "lead_123",
      "name": "John Doe",
      "email": "john@example.com",
      "company": "Acme Corp",
      "status": "new",
      "createdAt": "2025-01-10T10:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1,
    "totalPages": 1
  }
}
    PollyBot.ai - Smart Conversations, Seamless Automation