Create a new people list

curl --request POST \
  --url https://app.tryspecter.com/api/v1/lists/people \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "name": "My list",
  "people_ids": [
    "per_9bc79341808a72461d634256"
  ],
  "is_public": true
}
'

"a1d2434c-e089-480a-8a27-9909d2f558b4"

People Lists

Create a new people list

What it does

Creates a list of people that is shared with the API and returns the new list’s id.

Why you’d use it

Programmatically maintain outreach/diligence cohorts (e.g., founders, execs, domain experts) you’ll enrich, score, and sync to internal tools.

Key behaviours

Add people at creation by passing their person IDs, or add them later via the PUT endpoint for that list id.
The list owner will be the first team admin on your account.
List names must be unique; if a name already exists, rename the existing list or choose a new name.

POST

lists

people

Create a new people list

curl --request POST \
  --url https://app.tryspecter.com/api/v1/lists/people \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "name": "My list",
  "people_ids": [
    "per_9bc79341808a72461d634256"
  ],
  "is_public": true
}
'

"a1d2434c-e089-480a-8a27-9909d2f558b4"

Authorizations

X-API-Key

string

header

required

Body

application/json

name

string

required

Name of the list to create

Example:

"My list"

people_ids

string[]

ID of people being added

is_public

boolean

Whether the list is shared with other users in the team

Example:

true

Response

The ID of the list that was created

ID of the list

Example:

"a1d2434c-e089-480a-8a27-9909d2f558b4"

Get people list results Modify a people list

Documentation Index

Authorizations

Body

Response