Skip to main content
POST
Build a company list from a contact list's companies

Authorizations

Authorization
string
header
required

Your API token (af_…) as the Basic-auth username, with an empty password.

Path Parameters

listId
string
required

24-character hex id of the list (from GET /business/lists).

Body

application/json
name
string
required

Name for the new company list (1-255 characters); a name already in use answers 409 LIST_NAME_TAKEN.

Required string length: 1 - 255

Response

Success

list
object
required
sourceContacts
integer | null
required