<aside> 💡 Use this endpoint to request enrichment of a list of people.

If you do not know the names or LinkedIn profiles of the people you want to reach, use the Start New Enrichment Task (Companies) endpoint instead.

</aside>

To start a new task you must provide the following data:

Example Request

POST '<https://api.coldlytics.com/v2/tasks/enrich/people>
{
    "source": "The name of your app or platform",
    "title": "A descriptive title for your task",
    "contacts": [
        {
					"firstName": "Richard",
					"lastName": "Francis",
					"jobTitle": "Co-founder",
					"companyName": "Coldlytics",
					"domain": "coldlytics.com",
					"linkedInProfile": "<https://linkedin.com>..."
				},
				...
    ],
    "dataPoints": [
        "LinkedIn Profile",
        "Address",
        "Phone Number",
        "Company Facebook Profile",
        "Company Instagram Profile",
        "Company LinkedIn Profile"
    ],
    "webhook": "<http://www.example.com>"
}

Example Response

{
    "message": "Task started successfully."
}

Contacts required

The minimum number of contacts for one task is 20. If you submit less than this, the API will respond with a descriptive error and 422 status code. All contacts must be unique.

You can optionally provide any of the following attributes for each contact (the more the better):

Additionally, you must provide at least one of the following attributes for each contact:

Data Points optional