Lists

Create a list

Create a new list to organize people or companies. Use this to start building collections for outreach, tracking, or organization. Provide: title (required), type (people or company), and optional description. The creator becomes the list owner. List creation may be limited based on your subscription plan.

post/v2/lists

Request

  • Base URL: https://api.village.ai
  • URL: https://api.village.ai/v2/lists
  • Auth: HTTP bearer

Request body

titlestring required

List title

type'people' | 'company'

Type of entities in the list

descriptionstring

Optional list description

is_publicboolean

Whether the list is publicly accessible

Example request

{
  "title": "Sales Leads Q1",
  "type": "people",
  "description": "Qualified sales leads for Q1 outreach"
}

Response

List created successfully

Example response

{
  "data": {
    "public_id": "fintech-8f3k2"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.