INinstantly
LeadList

Create lead list

Requires one of the following scopes: lead_lists:create, lead_lists:all, all:create, all:all

post/api/v2/lead-lists

Request

  • Base URL
    https://api.instantly.ai
  • URL
    https://api.instantly.ai/api/v2/lead-lists
  • Auth
    HTTP bearer

Request body

has_enrichment_taskboolean nullable

Whether this list runs the enrichment process on every added lead or not

owned_bystring uuid nullable

User ID of the owner of this lead list. Defaults to the user that created the list

namestring required

Name of the lead list

Example request

{
  "owned_by": "01a19e6d-50c7-78d1-929c-13ca1b28d38e",
  "name": "My Lead List"
}

Response

The Lead List

idstring uuid required

Unique identifier for the lead list

organization_idstring uuid required

Organization ID that owns this lead list

has_enrichment_taskboolean nullable

Whether this list runs the enrichment process on every added lead or not

owned_bystring uuid nullable

User ID of the owner of this lead list. Defaults to the user that created the list

namestring required

Name of the lead list

timestamp_createdstring date-time required

Timestamp when the lead list was created

Example response

{
  "id": "01a19e6d-50c7-78d1-929c-13c804f5b3d0",
  "organization_id": "01a19e6d-50c7-78d1-929c-13c90e3cd756",
  "owned_by": "01a19e6d-50c7-78d1-929c-13ca1b28d38e",
  "name": "My Lead List",
  "timestamp_created": "2026-11-02T22:42:06.663Z"
}

Changes

No recorded changes to this operation across all 8 revisions of this API.