LeadSquared Integration

Overview

Connect your LeadSquared CRM to automatically trigger AI calls when new leads are created. Configure your agent to call leads with custom data mapping and call scheduling parameters. How It Works:

Connect LeadSquared account
Configure agent variable mapping
Add webhook URL to LeadSquared
New leads automatically trigger calls

Step 1: Connect LeadSquared Account

Navigate to Integrations

Go to Dashboard → Integrations

Find LeadSquared

Locate LeadSquared in the available integrations

Click Connect

Click the “Connect” button

Enter Credentials

Fill in the required fields:Host URL

Your LeadSquared API endpoint
Example: https://api-in21.leadsquared.com
Find this in your LeadSquared account settings

Access Key

Your LeadSquared access key
Found in Settings → API & Webhooks

Secret Key

Your LeadSquared secret key
Keep this secure and never share

Save Connection

Click “Connect” to save your credentials

Your credentials are stored securely and used only for API communication with LeadSquared.

Step 2: Configure Agent Variable Mapping

Map your agent’s call metadata variables to LeadSquared lead fields.

Go to Agent Configuration

Navigate to the agent you want to configure for LeadSquared leads

Open Variable Source Tab

Click on the “Variable Source” tab in agent settings

Add Variable Mapping

For each call metadata variable:

Click “Add Variable”
Enter Variable Name (e.g., name, phone, email)
Select Source: leadsquared
Select LeadSquared Field from dropdown
Choose Format if needed (optional)

Variable Mapping Example

Call Metadata Variable → LeadSquared Field
-----------------------------------------------
name                   → ProspectName
phone                  → Phone
email                  → EmailAddress
company                → Company
city                   → City

The agent will receive these values from LeadSquared when a call is triggered, using them during the conversation.

Step 3: Generate Webhook URL

Your webhook URL follows this format:

https://api.callkaro.ai/call/crm-webhook?agent_id=YOUR_AGENT_ID&type=leadsquared

Authentication

The webhook requires authentication. You can provide your API key in two ways: Option 1: Query Parameter

https://api.callkaro.ai/call/crm-webhook?agent_id=YOUR_AGENT_ID&type=leadsquared&x_api_key=YOUR_API_KEY

Option 2: Header

Add header: X-API-KEY: YOUR_API_KEY
Use this when query parameter is not preferred

Your API key can be found in Dashboard → API Keys

Get Your Agent ID

Go to your agent’s configuration page
Look in the URL or agent settings
Copy the agent ID

Complete Example URL (with API key):

https://api.callkaro.ai/call/crm-webhook?agent_id=6803fa770b666a64ab1694c1e&type=leadsquared&x_api_key=ck_1234567890abcdef

Step 4: Configure Webhook in LeadSquared

Log into LeadSquared

Access your LeadSquared account

Go to Webhooks

Navigate to Settings → API & Webhooks → Webhooks

Create New Webhook

Click “Create Webhook” or “Add Webhook”

Enter Webhook URL

Paste your Callkaro webhook URL with agent ID and API keyUsing Query Parameter (Recommended):

https://api.callkaro.ai/call/crm-webhook?agent_id=YOUR_AGENT_ID&type=leadsquared&x_api_key=YOUR_API_KEY

Add Authentication (If Using Header)

If you prefer header authentication:

Enter webhook URL without x_api_key parameter
Add custom header in LeadSquared:
- Header Name: X-API-KEY
- Header Value: Your Callkaro API key

Set Content-Type to JSON

Important: Set the Content-Type to application/json

Look for “Content-Type” or “Request Format” setting
Select application/json from the dropdown
Do NOT use form or application/x-www-form-urlencoded

LeadSquared often defaults to form - you MUST change this to application/json or the webhook will fail.

Select Trigger Event

Choose “Lead Created” or relevant trigger event

Save Webhook

Click “Save” to activate the webhook

Advanced Parameters

Add optional parameters to your webhook URL to control call behavior.

Available Parameters

Parameter	Format	Description	Example
`min_trigger_time`	`HH:MM`	Earliest time to trigger calls (24-hour format)	`09:00`
`max_trigger_time`	`HH:MM`	Latest time to trigger calls (24-hour format)	`18:00`
`carry_over`	`true`/`false`	Whether to carry over calls outside window to next day	`true`
`num_of_retries`	Number	Total number of retry attempts if call fails	`3`
`gap_between_retries`	`X,Y,Z`	Gap in hours between retries (comma-separated)	`2,4,6`

Parameter Examples

Basic Call Window
With Retries
With Carry Over
Complete Configuration

Configure calls between 9 AM and 6 PM:

https://api.callkaro.ai/call/crm-webhook?agent_id=YOUR_AGENT_ID&type=leadsquared&x_api_key=YOUR_API_KEY&min_trigger_time=09:00&max_trigger_time=18:00

Call window + 3 retries with increasing gaps:

https://api.callkaro.ai/call/crm-webhook?agent_id=YOUR_AGENT_ID&type=leadsquared&x_api_key=YOUR_API_KEY&min_trigger_time=09:00&max_trigger_time=18:00&num_of_retries=3&gap_between_retries=2,4,8

Retry Schedule:

Call 1: Lead created time
Call 2: 2 hours after first call (if failed)
Call 3: 4 hours after second call (if failed)
Call 4: 8 hours after third call (if failed)

Carry over missed calls to next day:

https://api.callkaro.ai/call/crm-webhook?agent_id=YOUR_AGENT_ID&type=leadsquared&x_api_key=YOUR_API_KEY&min_trigger_time=09:00&max_trigger_time=18:00&carry_over=true

Behavior:

Lead created at 8:00 PM (outside window)
With carry_over=true: Call scheduled for 9:00 AM next day
With carry_over=false: Call attempt immediately (may fail)

All parameters combined:

https://api.callkaro.ai/call/crm-webhook?agent_id=YOUR_AGENT_ID&type=leadsquared&x_api_key=YOUR_API_KEY&min_trigger_time=09:00&max_trigger_time=18:00&carry_over=true&num_of_retries=3&gap_between_retries=2,3,3

Parameter Details

min_trigger_time & max_trigger_time

Format: HH:MM (24-hour format) Purpose: Define the calling window for your campaigns Examples:

09:00 - 9:00 AM
13:30 - 1:30 PM
18:00 - 6:00 PM

Calls triggered outside this window will be handled based on carry_over setting.

carry_over

Format: true or false Purpose: Determines behavior for leads created outside calling hours Options:

true: Schedule call for next available time within window
false: Attempt call immediately (may fail if outside hours)

Example Scenario:

Settings:
min_trigger_time=09:00
max_trigger_time=18:00
carry_over=true

Lead created: 7:00 PM (outside window)
Result: Call scheduled for 9:00 AM next day

num_of_retries

Format: Number (integer) Purpose: Total number of retry attempts if call fails Valid Values: 0 to 10 Examples:

0 - No retries, single call attempt
1 - One retry (2 total attempts)
3 - Three retries (4 total attempts)

gap_between_retries

Format: Comma-separated hours X,Y,Z Purpose: Time gaps between retry attempts Important:

Number of values must equal num_of_retries
Values in hours
No spaces between commas

Examples:

Equal Gaps
Increasing Gaps
Custom Pattern

num_of_retries=3
gap_between_retries=2,2,2

Schedule:

Attempt 1: Lead created time
Attempt 2: +2 hours
Attempt 3: +2 hours
Attempt 4: +2 hours

num_of_retries=3
gap_between_retries=1,3,6

Schedule:

Attempt 1: Lead created time
Attempt 2: +1 hour
Attempt 3: +3 hours
Attempt 4: +6 hours

num_of_retries=4
gap_between_retries=2,4,6,12

Schedule:

Attempt 1: 10:00 AM (lead created)
Attempt 2: 12:00 PM (+2 hours)
Attempt 3: 4:00 PM (+4 hours)
Attempt 4: 10:00 PM (+6 hours)
Attempt 5: 10:00 AM next day (+12 hours)

Ensure the number of gap values matches num_of_retries exactly, or the webhook will fail.

Complete Setup Example

Scenario: Sales Team Lead Calls

Requirements:

Call new leads automatically
Business hours: 9 AM to 6 PM
Retry failed calls 3 times
Increasing gaps: 2, 4, 6 hours
Carry over evening leads to next morning

Webhook URL:

https://api.callkaro.ai/call/crm-webhook?agent_id=6803fa770b666a64ab1694c1e&type=leadsquared&x_api_key=ck_1234567890abcdef&min_trigger_time=09:00&max_trigger_time=18:00&carry_over=true&num_of_retries=3&gap_between_retries=2,4,6

Variable Mapping:

Call Metadata	LeadSquared Field
`name`	`ProspectName`
`phone`	`Phone`
`email`	`EmailAddress`
`company`	`Company`
`product_interest`	`mx_Product_Interest`

Result:

Lead created at 10 AM → Call at 10 AM
Lead created at 7 PM → Call at 9 AM next day
Failed calls retry: +2h, +4h, +6h
Agent has access to all mapped fields during call

Testing Your Integration

Create Test Lead

Create a test lead in LeadSquared with sample data

Check Webhook Trigger

Verify LeadSquared webhook fires successfully

Monitor Call

Check Callkaro dashboard for triggered call

Review Data

Confirm agent received correct lead data during call

Test Retries

Test retry behavior by marking call as failed

Troubleshooting

Calls not triggering

Possible causes:

Webhook URL incorrect
Agent ID wrong
LeadSquared webhook not saved
LeadSquared credentials invalid

Solutions:

Verify webhook URL format
Check agent ID is correct
Confirm webhook is active in LeadSquared
Test LeadSquared credentials in Integrations page

Variables not mapping

Issue: Agent doesn’t receive lead dataSolutions:

Check variable source is set to leadsquared
Verify LeadSquared field names are correct
Ensure fields exist in LeadSquared lead
Test with a lead that has all mapped fields

Calls outside window

Issue: Calls triggering outside min/max timesSolutions:

Check time format is HH:MM (24-hour)
Verify carry_over setting
Ensure timezone matches your LeadSquared account

Retries not working

Issue: No retry attempts after failed callSolutions:

Verify num_of_retries is set
Check gap_between_retries count matches retries
Ensure proper format: 2,3,4 (no spaces)
Confirm call actually failed (not just unanswered)

Invalid webhook error

Issue: LeadSquared shows webhook errorSolutions:

Check URL has no typos
Ensure type=leadsquared is included
Verify agent_id is valid
Remove any extra spaces or characters

Best Practices

Set Appropriate Call Windows

Why: Respect customer availability and increase answer ratesRecommendations:

Business hours: 09:00 to 18:00
Avoid early morning and late evening
Consider customer timezone

Use Intelligent Retry Patterns

Why: Balance persistence with customer experienceGood Patterns:

Quick follow-up: 1,2,4 hours
Spaced out: 4,8,24 hours
Aggressive: 1,1,2 hours

Avoid:

Too frequent: 0.5,0.5,0.5 (spam-like)
Too long: 24,48,72 (lost interest)

Enable Carry Over

Why: Never miss a lead due to timingBest Practice:

Set carry_over=true for most campaigns
Ensures all leads get called
Respects calling hours

Map Essential Fields Only

Why: Keep agent context focusedEssential Fields:

Name (for personalization)
Phone (validation)
Email (backup contact)
Product interest (conversation context)

Avoid:

Unnecessary personal data
Too many fields (overwhelming)
Sensitive information not needed

FAQs

Can I use multiple agents?

Yes! Create separate webhook URLs for each agent with different agent_ids.

What happens if LeadSquared is down?

Calls won’t trigger until LeadSquared service resumes. No data is lost.

Can I test without creating real leads?

Yes, use LeadSquared’s webhook test feature or create test leads in a sandbox.

How do I know if a call was triggered?

Check your Callkaro dashboard → Call History for new calls from this agent.

Can I change parameters later?

Yes, simply update the webhook URL in LeadSquared with new parameters.

Getting Help

Webhook Documentation

Learn more about webhooks and call data

Contact Support

Get help with LeadSquared integration setup

Getting started

Pricing

Voice AI Agents

Phone Numbers

Calls

Webhooks

Whatsapp (Facebook)

Integrations

Overview

Step 1: Connect LeadSquared Account

Step 2: Configure Agent Variable Mapping

Variable Mapping Example

Step 3: Generate Webhook URL

Authentication

Get Your Agent ID

Step 4: Configure Webhook in LeadSquared

Advanced Parameters

Available Parameters

Parameter Examples

Parameter Details

min_trigger_time & max_trigger_time

carry_over

num_of_retries

gap_between_retries

Complete Setup Example

Scenario: Sales Team Lead Calls

Testing Your Integration

Troubleshooting

Best Practices

FAQs

Getting Help

Webhook Documentation

Contact Support

Getting started

Pricing

Voice AI Agents

Phone Numbers

Calls

Webhooks

Whatsapp (Facebook)

Integrations

​Overview

​Step 1: Connect LeadSquared Account

​Step 2: Configure Agent Variable Mapping

​Variable Mapping Example

​Step 3: Generate Webhook URL

​Authentication

​Get Your Agent ID

​Step 4: Configure Webhook in LeadSquared

​Advanced Parameters

​Available Parameters

​Parameter Examples

​Parameter Details

​min_trigger_time & max_trigger_time

​carry_over

​num_of_retries

​gap_between_retries

​Complete Setup Example

​Scenario: Sales Team Lead Calls

​Testing Your Integration

​Troubleshooting

​Best Practices

​FAQs

​Getting Help

Webhook Documentation

Contact Support

Overview

Step 1: Connect LeadSquared Account

Step 2: Configure Agent Variable Mapping

Variable Mapping Example

Step 3: Generate Webhook URL

Authentication

Get Your Agent ID

Step 4: Configure Webhook in LeadSquared

Advanced Parameters

Available Parameters

Parameter Examples

Parameter Details

min_trigger_time & max_trigger_time

carry_over

num_of_retries

gap_between_retries

Complete Setup Example

Scenario: Sales Team Lead Calls

Testing Your Integration

Troubleshooting

Best Practices

FAQs

Getting Help