INinstantly
LeadList

Patch lead list

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

patch/api/v2/lead-lists/{id}

Request

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

Path parameters

idstring uuid required
Example:01a19e6f-891e-7490-9bca-6b80c5e3fdcd

The ID of the item to update

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

Name of the lead list

Example request

{
  "owned_by": "01a19e6f-3f5a-7da3-853b-6736b7f2d576",
  "name": "My Lead List"
}

Response

The updated 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": "01a19e6f-3f5a-7da3-853b-67347e9c8c7f",
  "organization_id": "01a19e6f-3f5a-7da3-853b-67352d6670b1",
  "owned_by": "01a19e6f-3f5a-7da3-853b-6736b7f2d576",
  "name": "My Lead List",
  "timestamp_created": "2026-11-02T22:44:13.274Z"
}

Changes

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