REST API

Add people to a people list

Add people by LinkedIn profile URL (up to 5000 per call), with optional name, title, company and e-mail.

POST/v1/people-lists/:list_id/items

MCP tool add_people_list_itemsscope lists:writeNo record cost

Parameters

list_idstringrequired

peopleobject[]required

(up to 5000 items)

What your agent reads

The tool description exactly as an MCP client receives it in tools/list — it doubles as the full behaviour of the endpoint.

Add people by LinkedIn profile URL (up to 5000 per call), with optional name, title, company and e-mail. Duplicates (same profile) are ignored; unreadable rows are reported. No record cost.

Errors follow one format.

Request

curl -X POST "https://api.breaknorm.co/v1/people-lists/plst_0123456789abcdef0123/items" \
  -H "Authorization: Bearer $BREAKNORM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "people": [
      {
        "linkedin": "https://www.linkedin.com/in/miguelarroja",
        "name": "Miguel Arroja",
        "title": "Sales Director",
        "company_domain": "deepgram.com"
      }
    ]
  }'