Add profiles to project

Add sourcing profiles to a project’s pipeline with automatic deduplication.

Important: Pass the full profile objects from search results (including experiences, educations, skills, summary, picture_url, and location). The more fields you include, the richer the created contact record will be. Fields like already_in_project and existing_contact_id are response-only and will be ignored if passed.

The endpoint performs cascade deduplication: if a profile matches an existing contact (by LinkedIn URL, then by name + company), the existing contact is updated with any missing fields instead of creating a duplicate.

POST /sourcing/add-to-project

Add profiles to project

cURL

curl --request POST \
  --url https://app.leonar.app/api/v1/sourcing/add-to-project \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "profiles": [
    {
      "profile_id": "ACwAABrjaVMBOLcCrV5aEw1zCAjE_zec6PbnU1A",
      "first_name": "Sophie",
      "last_name": "Martin",
      "headline": "Senior Software Engineer at Doctolib",
      "picture_url": "https://media.licdn.com/dms/image/example.jpg",
      "location": "Paris, Île-de-France, France",
      "linkedin_url": "https://www.linkedin.com/in/sophie-martin",
      "summary": "Experienced engineer with 8 years in full-stack development...",
      "current_job": {
        "title": "Senior Software Engineer",
        "company_name": "Doctolib"
      },
      "experiences": [
        {
          "title": "Senior Software Engineer",
          "company_name": "Doctolib",
          "start_date": "2021-03-01",
          "end_date": null,
          "description": "Leading backend team, Python/Django stack...",
          "is_current": true
        },
        {
          "title": "Software Engineer",
          "company_name": "Criteo",
          "start_date": "2018-01-01",
          "end_date": "2021-02-28",
          "description": "Built real-time bidding systems in Python...",
          "is_current": false
        }
      ],
      "educations": [
        {
          "educational_establishment": "École Polytechnique",
          "diploma": "Master of Engineering",
          "specialization": "Computer Science",
          "start_date": "2014-09-01",
          "end_date": "2018-06-30"
        }
      ],
      "skills": [
        "Python",
        "Django",
        "TypeScript",
        "PostgreSQL"
      ],
      "total_years_experience": 8.2,
      "already_in_project": false,
      "existing_contact_id": null
    }
  ],
  "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "resolve_names": false
}
'

import requests

url = "https://app.leonar.app/api/v1/sourcing/add-to-project"

payload = {
    "project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "profiles": [
        {
            "profile_id": "ACwAABrjaVMBOLcCrV5aEw1zCAjE_zec6PbnU1A",
            "first_name": "Sophie",
            "last_name": "Martin",
            "headline": "Senior Software Engineer at Doctolib",
            "picture_url": "https://media.licdn.com/dms/image/example.jpg",
            "location": "Paris, Île-de-France, France",
            "linkedin_url": "https://www.linkedin.com/in/sophie-martin",
            "summary": "Experienced engineer with 8 years in full-stack development...",
            "current_job": {
                "title": "Senior Software Engineer",
                "company_name": "Doctolib"
            },
            "experiences": [
                {
                    "title": "Senior Software Engineer",
                    "company_name": "Doctolib",
                    "start_date": "2021-03-01",
                    "end_date": None,
                    "description": "Leading backend team, Python/Django stack...",
                    "is_current": True
                },
                {
                    "title": "Software Engineer",
                    "company_name": "Criteo",
                    "start_date": "2018-01-01",
                    "end_date": "2021-02-28",
                    "description": "Built real-time bidding systems in Python...",
                    "is_current": False
                }
            ],
            "educations": [
                {
                    "educational_establishment": "École Polytechnique",
                    "diploma": "Master of Engineering",
                    "specialization": "Computer Science",
                    "start_date": "2014-09-01",
                    "end_date": "2018-06-30"
                }
            ],
            "skills": ["Python", "Django", "TypeScript", "PostgreSQL"],
            "total_years_experience": 8.2,
            "already_in_project": False,
            "existing_contact_id": None
        }
    ],
    "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "resolve_names": False
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    project_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    profiles: [
      {
        profile_id: 'ACwAABrjaVMBOLcCrV5aEw1zCAjE_zec6PbnU1A',
        first_name: 'Sophie',
        last_name: 'Martin',
        headline: 'Senior Software Engineer at Doctolib',
        picture_url: 'https://media.licdn.com/dms/image/example.jpg',
        location: 'Paris, Île-de-France, France',
        linkedin_url: 'https://www.linkedin.com/in/sophie-martin',
        summary: 'Experienced engineer with 8 years in full-stack development...',
        current_job: {title: 'Senior Software Engineer', company_name: 'Doctolib'},
        experiences: [
          {
            title: 'Senior Software Engineer',
            company_name: 'Doctolib',
            start_date: '2021-03-01',
            end_date: null,
            description: 'Leading backend team, Python/Django stack...',
            is_current: true
          },
          {
            title: 'Software Engineer',
            company_name: 'Criteo',
            start_date: '2018-01-01',
            end_date: '2021-02-28',
            description: 'Built real-time bidding systems in Python...',
            is_current: false
          }
        ],
        educations: [
          {
            educational_establishment: 'École Polytechnique',
            diploma: 'Master of Engineering',
            specialization: 'Computer Science',
            start_date: '2014-09-01',
            end_date: '2018-06-30'
          }
        ],
        skills: ['Python', 'Django', 'TypeScript', 'PostgreSQL'],
        total_years_experience: 8.2,
        already_in_project: false,
        existing_contact_id: null
      }
    ],
    account_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    resolve_names: false
  })
};

fetch('https://app.leonar.app/api/v1/sourcing/add-to-project', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.leonar.app/api/v1/sourcing/add-to-project",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'project_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'profiles' => [
        [
                'profile_id' => 'ACwAABrjaVMBOLcCrV5aEw1zCAjE_zec6PbnU1A',
                'first_name' => 'Sophie',
                'last_name' => 'Martin',
                'headline' => 'Senior Software Engineer at Doctolib',
                'picture_url' => 'https://media.licdn.com/dms/image/example.jpg',
                'location' => 'Paris, Île-de-France, France',
                'linkedin_url' => 'https://www.linkedin.com/in/sophie-martin',
                'summary' => 'Experienced engineer with 8 years in full-stack development...',
                'current_job' => [
                                'title' => 'Senior Software Engineer',
                                'company_name' => 'Doctolib'
                ],
                'experiences' => [
                                [
                                                                'title' => 'Senior Software Engineer',
                                                                'company_name' => 'Doctolib',
                                                                'start_date' => '2021-03-01',
                                                                'end_date' => null,
                                                                'description' => 'Leading backend team, Python/Django stack...',
                                                                'is_current' => true
                                ],
                                [
                                                                'title' => 'Software Engineer',
                                                                'company_name' => 'Criteo',
                                                                'start_date' => '2018-01-01',
                                                                'end_date' => '2021-02-28',
                                                                'description' => 'Built real-time bidding systems in Python...',
                                                                'is_current' => false
                                ]
                ],
                'educations' => [
                                [
                                                                'educational_establishment' => 'École Polytechnique',
                                                                'diploma' => 'Master of Engineering',
                                                                'specialization' => 'Computer Science',
                                                                'start_date' => '2014-09-01',
                                                                'end_date' => '2018-06-30'
                                ]
                ],
                'skills' => [
                                'Python',
                                'Django',
                                'TypeScript',
                                'PostgreSQL'
                ],
                'total_years_experience' => 8.2,
                'already_in_project' => false,
                'existing_contact_id' => null
        ]
    ],
    'account_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'resolve_names' => false
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.leonar.app/api/v1/sourcing/add-to-project"

	payload := strings.NewReader("{\n  \"project_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"profiles\": [\n    {\n      \"profile_id\": \"ACwAABrjaVMBOLcCrV5aEw1zCAjE_zec6PbnU1A\",\n      \"first_name\": \"Sophie\",\n      \"last_name\": \"Martin\",\n      \"headline\": \"Senior Software Engineer at Doctolib\",\n      \"picture_url\": \"https://media.licdn.com/dms/image/example.jpg\",\n      \"location\": \"Paris, Île-de-France, France\",\n      \"linkedin_url\": \"https://www.linkedin.com/in/sophie-martin\",\n      \"summary\": \"Experienced engineer with 8 years in full-stack development...\",\n      \"current_job\": {\n        \"title\": \"Senior Software Engineer\",\n        \"company_name\": \"Doctolib\"\n      },\n      \"experiences\": [\n        {\n          \"title\": \"Senior Software Engineer\",\n          \"company_name\": \"Doctolib\",\n          \"start_date\": \"2021-03-01\",\n          \"end_date\": null,\n          \"description\": \"Leading backend team, Python/Django stack...\",\n          \"is_current\": true\n        },\n        {\n          \"title\": \"Software Engineer\",\n          \"company_name\": \"Criteo\",\n          \"start_date\": \"2018-01-01\",\n          \"end_date\": \"2021-02-28\",\n          \"description\": \"Built real-time bidding systems in Python...\",\n          \"is_current\": false\n        }\n      ],\n      \"educations\": [\n        {\n          \"educational_establishment\": \"École Polytechnique\",\n          \"diploma\": \"Master of Engineering\",\n          \"specialization\": \"Computer Science\",\n          \"start_date\": \"2014-09-01\",\n          \"end_date\": \"2018-06-30\"\n        }\n      ],\n      \"skills\": [\n        \"Python\",\n        \"Django\",\n        \"TypeScript\",\n        \"PostgreSQL\"\n      ],\n      \"total_years_experience\": 8.2,\n      \"already_in_project\": false,\n      \"existing_contact_id\": null\n    }\n  ],\n  \"account_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"resolve_names\": false\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.leonar.app/api/v1/sourcing/add-to-project")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"project_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"profiles\": [\n    {\n      \"profile_id\": \"ACwAABrjaVMBOLcCrV5aEw1zCAjE_zec6PbnU1A\",\n      \"first_name\": \"Sophie\",\n      \"last_name\": \"Martin\",\n      \"headline\": \"Senior Software Engineer at Doctolib\",\n      \"picture_url\": \"https://media.licdn.com/dms/image/example.jpg\",\n      \"location\": \"Paris, Île-de-France, France\",\n      \"linkedin_url\": \"https://www.linkedin.com/in/sophie-martin\",\n      \"summary\": \"Experienced engineer with 8 years in full-stack development...\",\n      \"current_job\": {\n        \"title\": \"Senior Software Engineer\",\n        \"company_name\": \"Doctolib\"\n      },\n      \"experiences\": [\n        {\n          \"title\": \"Senior Software Engineer\",\n          \"company_name\": \"Doctolib\",\n          \"start_date\": \"2021-03-01\",\n          \"end_date\": null,\n          \"description\": \"Leading backend team, Python/Django stack...\",\n          \"is_current\": true\n        },\n        {\n          \"title\": \"Software Engineer\",\n          \"company_name\": \"Criteo\",\n          \"start_date\": \"2018-01-01\",\n          \"end_date\": \"2021-02-28\",\n          \"description\": \"Built real-time bidding systems in Python...\",\n          \"is_current\": false\n        }\n      ],\n      \"educations\": [\n        {\n          \"educational_establishment\": \"École Polytechnique\",\n          \"diploma\": \"Master of Engineering\",\n          \"specialization\": \"Computer Science\",\n          \"start_date\": \"2014-09-01\",\n          \"end_date\": \"2018-06-30\"\n        }\n      ],\n      \"skills\": [\n        \"Python\",\n        \"Django\",\n        \"TypeScript\",\n        \"PostgreSQL\"\n      ],\n      \"total_years_experience\": 8.2,\n      \"already_in_project\": false,\n      \"existing_contact_id\": null\n    }\n  ],\n  \"account_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"resolve_names\": false\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.leonar.app/api/v1/sourcing/add-to-project")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"project_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"profiles\": [\n    {\n      \"profile_id\": \"ACwAABrjaVMBOLcCrV5aEw1zCAjE_zec6PbnU1A\",\n      \"first_name\": \"Sophie\",\n      \"last_name\": \"Martin\",\n      \"headline\": \"Senior Software Engineer at Doctolib\",\n      \"picture_url\": \"https://media.licdn.com/dms/image/example.jpg\",\n      \"location\": \"Paris, Île-de-France, France\",\n      \"linkedin_url\": \"https://www.linkedin.com/in/sophie-martin\",\n      \"summary\": \"Experienced engineer with 8 years in full-stack development...\",\n      \"current_job\": {\n        \"title\": \"Senior Software Engineer\",\n        \"company_name\": \"Doctolib\"\n      },\n      \"experiences\": [\n        {\n          \"title\": \"Senior Software Engineer\",\n          \"company_name\": \"Doctolib\",\n          \"start_date\": \"2021-03-01\",\n          \"end_date\": null,\n          \"description\": \"Leading backend team, Python/Django stack...\",\n          \"is_current\": true\n        },\n        {\n          \"title\": \"Software Engineer\",\n          \"company_name\": \"Criteo\",\n          \"start_date\": \"2018-01-01\",\n          \"end_date\": \"2021-02-28\",\n          \"description\": \"Built real-time bidding systems in Python...\",\n          \"is_current\": false\n        }\n      ],\n      \"educations\": [\n        {\n          \"educational_establishment\": \"École Polytechnique\",\n          \"diploma\": \"Master of Engineering\",\n          \"specialization\": \"Computer Science\",\n          \"start_date\": \"2014-09-01\",\n          \"end_date\": \"2018-06-30\"\n        }\n      ],\n      \"skills\": [\n        \"Python\",\n        \"Django\",\n        \"TypeScript\",\n        \"PostgreSQL\"\n      ],\n      \"total_years_experience\": 8.2,\n      \"already_in_project\": false,\n      \"existing_contact_id\": null\n    }\n  ],\n  \"account_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"resolve_names\": false\n}"

response = http.request(request)
puts response.read_body

201

{
  "data": {
    "added": 5,
    "skipped": 2,
    "contact_ids": [
      "a1b2c3d4-5678-90ab-cdef-1234567890ab",
      "b2c3d4e5-6789-01ab-cdef-234567890abc",
      "c3d4e5f6-7890-12ab-cdef-345678901bcd",
      "d4e5f6a7-8901-23bc-defa-456789012cde",
      "e5f6a7b8-9012-34cd-efab-567890123def"
    ],
    "skipped_profiles": [
      {
        "profile_id": "urn:li:member:123456",
        "reason": "already_in_project"
      },
      {
        "profile_id": "urn:li:member:789012",
        "reason": "already_in_project"
      }
    ],
    "stage": {
      "id": "f6a7b8c9-0123-45de-fabc-678901234ef0",
      "name": "Sourced",
      "category": "sourced"
    }
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "Invalid input"
  }
}

{
  "error": {
    "code": "invalid_api_key",
    "message": "Invalid API key"
  }
}

Authorizations

Authorization · string · header · required

API key starting with leo_

Body

application/json

project_id · string<uuid> · required

Target project ID. Profiles are added to the first stage of this project's pipeline.

profiles · object[] · required

Profile objects from search results. Pass them directly from the search response for maximum data capture. Key fields that enrich the contact record:

• experiences → stored as work history (positions)
• educations → stored as education history (schools)
• skills → stored as skills list
• summary → stored as professional bio
• picture_url → stored as contact avatar
• location → stored as contact location
• current_job → sets the contact's job title and company

Required array length: 1 - 100 elements

Show child attributes

account_id · string<uuid>

Connected LinkedIn account ID. Required when resolve_names is true. Get it from GET /connected-accounts.

resolve_names · boolean · default: false

When true, automatically resolves missing first_name/last_name via LinkedIn profile lookup for profiles that have a linkedin_url. Requires account_id. Recommended when using LinkedIn Classic search results which often return null names.

Response

201

application/json

Profiles added

data · object

Show child attributes