Skip to main content

​
POST /api/v1/public/lead-lists/:list_id/import/

Import leads into a lead list. Auth: X-API-Key Body 
{
  "leads": [
    {
      "first_name": "Alex",
      "last_name": "Doe",
      "linkedin_profile_url": "https://www.linkedin.com/in/alex-doe/",
      "profile_picture_url": "https://example.com/alex.jpg",
      "job_title": "Head of Sales",
      "industry": "SaaS",
      "email": "alex@example.com",
      "phone_number": "+1 555 0100",
      "location": "Amsterdam, NL",
      "custom_fields": { "plan": "pro" },
      "company_name": "Acme Inc",
      "company_industry": "Software",
      "company_linkedin_url": "https://www.linkedin.com/company/acme/",
      "company_website_url": "https://acme.com",
      "company_location": "Amsterdam, NL"
    }
  ]
}
Fields
  • Array name: leads
  • first_name (required)
  • last_name (required)
  • linkedin_profile_url (required)
  • profile_picture_url (optional)
  • job_title (optional)
  • industry (optional)
  • email (optional)
  • phone_number (optional)
  • location (optional)
  • custom_fields (optional JSON object)
  • company_name (optional)
  • company_industry (optional)
  • company_linkedin_url (optional)
  • company_website_url (optional)
  • company_location (optional)
Notes
  • You can also send a nested company object with keys name, website_url, linkedin_url, industry, location instead of the flattened company_* fields. The API accepts either format.