Add people to a list by LinkedIn URL, answering one outcome per URL

POST /v1/lists/{id}/people

Permission needed: lists:write

Limited to 10 calls per minute per key, on top of the limit on all calls.

Parameters

NameInTypeRequiredNotes
idpathintegerYesMinimum 1
databodyYes

Responses

  • 200 Outcome of each URL
  • 400 Missing or invalid field
  • 404 The list does not exist
  • 429 Too many requests

Examples

curl
curl -X POST 'https://api.novatalent.com/v1/lists/123/people' \
  -H "X-Api-Key: $NOVA_API_KEY"
Node
const response = await fetch('https://api.novatalent.com/v1/lists/123/people', {
  method: 'POST',
  headers: { 'X-Api-Key': process.env.NOVA_API_KEY },
});
console.log(response.status, await response.json());
PHP
<?php
$curl = curl_init('https://api.novatalent.com/v1/lists/123/people');
curl_setopt_array($curl, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['X-Api-Key: ' . getenv('NOVA_API_KEY')],
]);
$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
echo $status . " " . $response;