Quickstart

Get Your API Key

Log in to your LeadLex Dashboard
Navigate to Settings → API & Integrations
Click Create API Key
Give your key a name (e.g., “My Bot”)
Select permissions:
- Read: View contacts, lists, campaigns
- Write: Create and update data
- Lexi: Interact with Lexi AI
Click Create

Save your API key immediately! You won’t be able to see it again after closing the dialog.

Your API key will start with wbk_ (workspace key) and look like this:

wbk_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0u1v2w3x4y5z6

Make Your First Request

Let’s list your contacts using cURL:

curl https://data.leadlex.com/functions/v1/api-gateway/v1/contacts \
  -H "Authorization: Bearer wbk_your_api_key_here"

import requests

API_KEY = "wbk_your_api_key_here"
BASE_URL = "https://data.leadlex.com/functions/v1/api-gateway"

headers = {"Authorization": f"Bearer {API_KEY}"}
response = requests.get(f"{BASE_URL}/v1/contacts", headers=headers)

if response.status_code == 200:
    data = response.json()
    print(f"Found {len(data['data']['contacts'])} contacts")
else:
    print(f"Error: {response.json()['error']['message']}")

const API_KEY = 'wbk_your_api_key_here';
const BASE_URL = 'https://data.leadlex.com/functions/v1/api-gateway';

async function listContacts() {
  const response = await fetch(`${BASE_URL}/v1/contacts`, {
    headers: { 'Authorization': `Bearer ${API_KEY}` }
  });
  
  if (response.ok) {
    const data = await response.json();
    console.log(`Found ${data.data.contacts.length} contacts`);
  } else {
    const error = await response.json();
    console.error(`Error: ${error.error.message}`);
  }
}

listContacts();

Expected Response

{
  "data": {
    "contacts": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "full_name": "Jane Doe",
        "email": "jane@example.com",
        "phone": "+1234567890",
        "job_title": "General Counsel",
        "company_name": "Acme Legal",
        "created_at": "2026-02-24T10:00:00Z"
      }
    ]
  },
  "meta": {
    "page": 1,
    "per_page": 50,
    "total": 1
  }
}

Create a Contact

Now let’s create a new contact:

curl -X POST \
  https://data.leadlex.com/functions/v1/api-gateway/v1/contacts \
  -H "Authorization: Bearer wbk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "full_name": "John Smith",
    "email": "john@example.com",
    "job_title": "CEO",
    "company_name": "Tech Corp"
  }'

import requests

API_KEY = "wbk_your_api_key_here"
BASE_URL = "https://data.leadlex.com/functions/v1/api-gateway"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

data = {
    "full_name": "John Smith",
    "email": "john@example.com",
    "job_title": "CEO",
    "company_name": "Tech Corp"
}

response = requests.post(f"{BASE_URL}/v1/contacts", headers=headers, json=data)

if response.status_code == 200:
    contact = response.json()["data"]
    print(f"Created contact: {contact['id']}")
else:
    print(f"Error: {response.json()['error']['message']}")

const API_KEY = 'wbk_your_api_key_here';
const BASE_URL = 'https://data.leadlex.com/functions/v1/api-gateway';

async function createContact() {
  const response = await fetch(`${BASE_URL}/v1/contacts`, {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${API_KEY}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      full_name: 'John Smith',
      email: 'john@example.com',
      job_title: 'CEO',
      company_name: 'Tech Corp'
    })
  });
  
  if (response.ok) {
    const data = await response.json();
    console.log(`Created contact: ${data.data.id}`);
  } else {
    const error = await response.json();
    console.error(`Error: ${error.error.message}`);
  }
}

createContact();

Check Rate Limits

Every API response includes rate limit headers:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 995
X-RateLimit-Reset: 1708905600

Rate limits reset at midnight UTC. Check the X-RateLimit-Remaining header to track your usage.

Next Steps

Authentication

Learn about API keys, permissions, and rate limits

Code Examples

Complete workflows for common use cases

API Reference

Browse all available endpoints

Webhooks

Get notified when events occur in your workspace

Getting Started

Core Concepts

Get Your API Key

Make Your First Request

Expected Response

Create a Contact

Check Rate Limits

Next Steps

Authentication

Code Examples

API Reference

Webhooks

​Get Your API Key

​Make Your First Request

​Expected Response

​Create a Contact

​Check Rate Limits

​Next Steps

Authentication

Code Examples

API Reference

Webhooks

Get Your API Key

Make Your First Request

Expected Response

Create a Contact

Check Rate Limits

Next Steps