Create List

POST

lists

curl -X POST "https://api.clustr-ai.com/api/public/lists" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Q3 target accounts", "entity_type": "accounts"}'

{
  "success": true,
  "data": { "message": "List created successfully" }
}

{
  "success": false,
  "error": { "message": "entity_type must be one of people, accounts", "code": "BAD_REQUEST" }
}

Creates the list. Add members afterward with Add Companies To List or Add People To List.

Body

string

required

string

required

people or accounts.

string

default:"membership"

membership (a static, hand-picked set) or filter (a saved query). Membership is what you want for “these specific ones” — see Lists.

curl -X POST "https://api.clustr-ai.com/api/public/lists" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Q3 target accounts", "entity_type": "accounts"}'

{
  "success": true,
  "data": { "message": "List created successfully" }
}

{
  "success": false,
  "error": { "message": "entity_type must be one of people, accounts", "code": "BAD_REQUEST" }
}

curl -X POST "https://api.clustr-ai.com/api/public/lists" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Q3 target accounts", "entity_type": "accounts"}'

{
  "success": true,
  "data": { "message": "List created successfully" }
}

{
  "success": false,
  "error": { "message": "entity_type must be one of people, accounts", "code": "BAD_REQUEST" }
}

API Reference

Import

Search

Jobs

Network

Opportunities

Owners

Accounts

Account States

Saved Views

Workflows

Intro Requests

Record Activity

Lists

Tags

Account Tags

Target Accounts

Client Companies

ICP

Competitor Monitoring

Connector Refresh

Notifications

Body

​Body

Body