Create a new company list

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

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

Company Lists

Create a new company list

What it does

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

Why you’d use it

Programmatically build and maintain sourcing/diligence shortlists (e.g., thesis- or region-based cohorts such as “European B2B DeepTech”)

Key behaviours

Add companies at creation by passing their company IDs, or add them later via the PATCH endpoint for that list id.
The list owner will be the first team admin added to the account.
You cannot create two lists with the same name. List names must be unique; if a name already exists, rename the existing list or choose a new name.

POST

lists

companies

Create a new company list

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

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

Authorizations

X-API-Key

string

header

required

Body

application/json

Name and list of companies to add to the new list

name

string

required

Name of the list to create

Example:

"My list"

company_ids

string[]

ID of company 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 company list results Modify a company list

Documentation Index

Authorizations

Body

Response