Skip to main content
POST
/
api
/
v1
/
operations
/
crm
/
export
{
  "selection": {
    "mode": "manual",
    "includedIds": [
      "lead_abc123",
      "lead_def456",
      "lead_ghi789"
    ]
  },
  "options": {
    "provider": "bullhorn",
    "checkForDuplicates": true,
    "duplicateHandling": "skip",
    "createNewHandling": "create"
  }
}

{
  "success": true,
  "totalProcessed": 3,
  "created": 2,
  "updated": 0,
  "skipped": 1,
  "failed": 0,
  "results": [
    {
      "leadId": "lead_abc123",
      "personName": "Jane Smith",
      "companyName": "Acme Corp",
      "status": "created",
      "crmLeadId": "crm_lead_001",
      "crmContactId": "crm_contact_001"
    },
    {
      "leadId": "lead_def456",
      "personName": "John Doe",
      "companyName": "Tech Inc",
      "status": "created",
      "crmLeadId": "crm_lead_002",
      "crmContactId": "crm_contact_002"
    },
    {
      "leadId": "lead_ghi789",
      "personName": "Bob Wilson",
      "companyName": "StartupXYZ",
      "status": "skipped"
    }
  ]
}

​
Overview

This endpoint exports leads from Lance to your connected CRM. It supports bulk selection of leads and configurable duplicate handling strategies.

​
Authentication

This endpoint requires authentication. The organization ID is automatically extracted from the authenticated session.

​
Request Body

​
selection
object
required
Defines which leads to export using bulk selection.
​
options
object
required
Export configuration options.

​
Response

​
success
boolean
required
Whether the overall export operation completed successfully.
​
totalProcessed
integer
required
Total number of leads processed in this export.
​
created
integer
required
Number of new contacts/leads created in the CRM.
​
updated
integer
required
Number of existing contacts/leads updated in the CRM.
​
skipped
integer
required
Number of leads skipped (due to duplicate handling or other rules).
​
failed
integer
required
Number of leads that failed to export.
​
results
array
required
Detailed results for each lead processed.
​
errors
string[]
Array of general error messages encountered during export.

​
Error Responses

Status CodeErrorDescription
400Organization ID requiredNo authenticated organization found
400CRM is not connectedOrganization has no CRM integration configured
400CRM provider mismatchRequested provider doesn’t match connected CRM
400Invalid requestRequest body validation failed
{
  "selection": {
    "mode": "manual",
    "includedIds": [
      "lead_abc123",
      "lead_def456",
      "lead_ghi789"
    ]
  },
  "options": {
    "provider": "bullhorn",
    "checkForDuplicates": true,
    "duplicateHandling": "skip",
    "createNewHandling": "create"
  }
}

{
  "success": true,
  "totalProcessed": 3,
  "created": 2,
  "updated": 0,
  "skipped": 1,
  "failed": 0,
  "results": [
    {
      "leadId": "lead_abc123",
      "personName": "Jane Smith",
      "companyName": "Acme Corp",
      "status": "created",
      "crmLeadId": "crm_lead_001",
      "crmContactId": "crm_contact_001"
    },
    {
      "leadId": "lead_def456",
      "personName": "John Doe",
      "companyName": "Tech Inc",
      "status": "created",
      "crmLeadId": "crm_lead_002",
      "crmContactId": "crm_contact_002"
    },
    {
      "leadId": "lead_ghi789",
      "personName": "Bob Wilson",
      "companyName": "StartupXYZ",
      "status": "skipped"
    }
  ]
}