<aside> 💡 Use this endpoint to request enrichment of a list of companies, when you know the seniority/job titles of the people you want to reach.

If you already know the names or LinkedIn Profiles of people you want to reach, use our Start New Enrichment Task (People) endpoint.

</aside>

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

• Domain names (websites) of the companies you wish to find contacts for.
• Desired seniority level(s).
• Desired job function(s).
• Desired data points.
• The full URL of the webhook to where we will deliver the results.

Example Request

POST '<https://api.coldlytics.com/v2/tasks/enrich/companies>
{
    "source": "The name of your app or platform",
    "title": "A descriptive title for your task",
    "domains": [
        "example.com",
        ...
    ],
    "seniorityLevels": [
        "Owners/Founders",
        ...
    ],
    "jobFunctions": [
        "Administrative",
        ...
    ],
    "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."
}

Domain Names required

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

Seniority Levels required

The accepted seniority levels are:

• Owners/Founders
• Directors & Executives
• Middle Management
• Staff

Job Functions required