Delete Campaign Blocked Leads

curl --request DELETE \
  --url https://app-api.walead.ai/api/v1/campaigns/{campaignId}/blocked-leads \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "publicIdentifiers": [
    "<string>"
  ]
}
'

import requests

url = "https://app-api.walead.ai/api/v1/campaigns/{campaignId}/blocked-leads"

payload = { "publicIdentifiers": ["<string>"] }
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.delete(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'DELETE',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({publicIdentifiers: ['<string>']})
};

fetch('https://app-api.walead.ai/api/v1/campaigns/{campaignId}/blocked-leads', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app-api.walead.ai/api/v1/campaigns/{campaignId}/blocked-leads",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_POSTFIELDS => json_encode([
    'publicIdentifiers' => [
        '<string>'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app-api.walead.ai/api/v1/campaigns/{campaignId}/blocked-leads"

	payload := strings.NewReader("{\n  \"publicIdentifiers\": [\n    \"<string>\"\n  ]\n}")

	req, _ := http.NewRequest("DELETE", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.delete("https://app-api.walead.ai/api/v1/campaigns/{campaignId}/blocked-leads")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"publicIdentifiers\": [\n    \"<string>\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app-api.walead.ai/api/v1/campaigns/{campaignId}/blocked-leads")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"publicIdentifiers\": [\n    \"<string>\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "message": "<string>",
  "unblocked": 123
}

{
  "statusCode": 123,
  "message": "<string>"
}

{
  "statusCode": 123,
  "message": "<string>"
}

{
  "statusCode": 123,
  "message": "<string>"
}

{
  "statusCode": 123,
  "message": "<string>"
}

DELETE

campaigns

{campaignId}

blocked-leads

Delete Campaign Blocked Leads

curl --request DELETE \
  --url https://app-api.walead.ai/api/v1/campaigns/{campaignId}/blocked-leads \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "publicIdentifiers": [
    "<string>"
  ]
}
'

import requests

url = "https://app-api.walead.ai/api/v1/campaigns/{campaignId}/blocked-leads"

payload = { "publicIdentifiers": ["<string>"] }
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.delete(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'DELETE',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({publicIdentifiers: ['<string>']})
};

fetch('https://app-api.walead.ai/api/v1/campaigns/{campaignId}/blocked-leads', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app-api.walead.ai/api/v1/campaigns/{campaignId}/blocked-leads",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_POSTFIELDS => json_encode([
    'publicIdentifiers' => [
        '<string>'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app-api.walead.ai/api/v1/campaigns/{campaignId}/blocked-leads"

	payload := strings.NewReader("{\n  \"publicIdentifiers\": [\n    \"<string>\"\n  ]\n}")

	req, _ := http.NewRequest("DELETE", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.delete("https://app-api.walead.ai/api/v1/campaigns/{campaignId}/blocked-leads")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"publicIdentifiers\": [\n    \"<string>\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app-api.walead.ai/api/v1/campaigns/{campaignId}/blocked-leads")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"publicIdentifiers\": [\n    \"<string>\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "message": "<string>",
  "unblocked": 123
}

{
  "statusCode": 123,
  "message": "<string>"
}

{
  "statusCode": 123,
  "message": "<string>"
}

{
  "statusCode": 123,
  "message": "<string>"
}

{
  "statusCode": 123,
  "message": "<string>"
}

Overview

Removes leads from the blocked list of a specific campaign, allowing them to receive campaign messages again. This endpoint unblocks previously blocked LinkedIn profiles.

License Requirement: This endpoint requires a Pro or Agency license to use.

Use Cases

Unblock Contacts: Remove leads from the blocked list to allow outreach
Correct Mistakes: Restore leads that were blocked by error
Update Targeting: Re-enable contact with leads that now match your criteria

Authentication

All requests require an API key passed in the x-api-key header. You can generate your API key from the WaLead dashboard.

Example Request

curl -X DELETE https://app-api.walead.ai/api/v1/campaigns/CAMPAIGN_ID/blocked-leads \
  -H "x-api-key: YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "publicIdentifiers": [
      "john-doe",
      "jane-smith"
    ]
  }'

Request Details

This endpoint requires an API key for authentication and accepts an array of LinkedIn public identifiers to unblock.

Request Body

The body should contain:

publicIdentifiers (required): Array of LinkedIn public identifiers to unblock

Public Identifiers

The publicIdentifiers field should contain LinkedIn profile identifiers (the username part of a LinkedIn URL). For example, from linkedin.com/in/john-doe, the public identifier would be john-doe.

Important Notes

License Required: Pro or Agency license is required to use this endpoint
The publicIdentifiers array is required and must not be empty
You can unblock multiple leads in a single request
Unblocked leads will be able to receive campaign messages again
This only affects the specific campaign’s blocked list
This is a public route that requires API key authentication

Authorizations

x-api-key

string

header

required

API key for authentication. Generate from your WaLead dashboard.

Path Parameters

campaignId

string

required

Campaign ID

Body

application/json

Public identifiers of leads to unblock

publicIdentifiers

string[]

required

Array of LinkedIn public identifiers to block (e.g., 'john-doe' from linkedin.com/in/john-doe)

Response

Leads unblocked successfully

success

boolean

Whether the operation was successful

message

string

Response message

unblocked

integer

Number of leads unblocked

API documentation

MCP Integration

Campaigns

Senders

Leads

Sequences

Conversations

Analytics

Webhooks

Delete Campaign Blocked Leads

Overview

Use Cases

Authentication

Example Request

Request Details

Request Body

Public Identifiers

Important Notes

Authorizations

Path Parameters

Body

Response

​Overview

​Use Cases

​Authentication

​Example Request

​Request Details

​Request Body

​Public Identifiers

​Important Notes

Authorizations

Path Parameters

Body

Response

Overview

Use Cases

Authentication

Example Request

Request Details

Request Body

Public Identifiers

Important Notes