Skip to main content
DELETE
/
api
/
v2
/
leads
Delete leads in bulk
curl --request DELETE \
  --url https://api.instantly.ai/api/v2/leads \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "campaign_id": "019cc043-e39a-7712-86ae-491a1554b0c1",
  "list_id": "019cc043-e39a-7712-86ae-491b1242d168"
}
'
{
  "count": 5
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
campaign_id
string<uuid>
required

The ID of the campaign to delete leads from. Required if list_id is not provided.

Example:

"019cc043-e39a-7712-86ae-491a1554b0c1"

​
list_id
string<uuid>

The ID of the list to delete leads from. Required if campaign_id is not provided.

Example:

"019cc043-e39a-7712-86ae-491b1242d168"

​
status
enum<number>

Optional status filter. Only delete leads with this status.

Available options:
1,
2,
3,
-1,
-2,
-3
Example:

3

​
ids
string<uuid>[]

Optional array of specific lead IDs to delete. When provided, only these leads will be deleted from the specified campaign or list.

​
limit
integer

Maximum number of leads to delete. If not specified, all matching leads will be deleted.

Required range: 1 <= x <= 10000
Example:

100

Response

Default Response

​
count
integer

Number of leads successfully deleted.

Example:

5