INinstantly
Lead

Delete leads in bulk

Delete multiple leads from a campaign or list based on filters. You must provide either campaign_id or list_id. Optionally filter by status or specific IDs.

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

delete/api/v2/leads

Request

  • Base URL
    https://api.instantly.ai
  • URL
    https://api.instantly.ai/api/v2/leads
  • Auth
    HTTP bearer

Request body

OR

Example request

{
  "campaign_id": "01a19e6d-925c-77c9-a649-505ea2f8aa22",
  "list_id": "01a19e6d-925c-77c9-a649-505fa220a1d1",
  "status": 3,
  "ids": [
    "01a19e6d-925c-77c9-a649-506060e64a75"
  ],
  "limit": 100
}

Response

Default Response

countinteger

Number of leads successfully deleted.

Example response

{
  "count": 5
}

Changes

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