INinstantly
LeadList

Delete lead list

Changed on

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

delete/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:01a19e6d-9243-7fb6-9e2b-c048dbd6eec6

The ID of the item to delete

Response

The deleted 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

background_job_idstring

Set when more than 1,000 leads are deleted: a background job does the delete. Check its progress with GET /background-jobs/:id.

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",
  "background_job_id": "6650f1c2a8b4e3d2c1f0a9b8"
}

Changes

  • c781051105a8Revision changes
    • breaking

      removed the request body

    • breaking

      the response's body type changed from object to no type for status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • info

      added subschema #2 to the response body allOf list for the response status