Skip to main content
DELETE
/
v1
/
blocked-leads
Delete Workspace Blocked Leads
curl --request DELETE \
  --url https://app-api.walead.ai/api/v1/blocked-leads \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '[
  "<string>"
]'
{
  "success": true,
  "message": "<string>",
  "unblocked": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.walead.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Removes leads from the workspace-level blocked list, allowing them to receive campaign messages again. This endpoint unblocks previously blocked LinkedIn profiles across all campaigns in the workspace.

​
Use Cases

  • Unblock Globally: Remove leads from workspace-wide blocked list
  • Re-enable Contact: Allow previously blocked leads to be contacted again
  • Correct Mistakes: Restore leads that were blocked by error
  • Update Compliance List: Remove contacts from the exclusion list when appropriate

​
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/blocked-leads \
  -H "x-api-key: YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '[
    "blocked-lead-id-1",
    "blocked-lead-id-2",
    "blocked-lead-id-3"
  ]'

​
Request Details

This endpoint requires an API key for authentication and accepts an array of blocked lead IDs to remove.

​
Request Body

The body should be an array of strings containing the IDs of the blocked lead records to delete: 
[
  "blocked-lead-id-1",
  "blocked-lead-id-2",
  "blocked-lead-id-3"
]

​
Getting Blocked Lead IDs

Use the GET /v1/blocked-leads endpoint to retrieve the list of blocked leads with their IDs before attempting to delete them.

​
Important Notes

  • The request body must be an array of blocked lead IDs (not public identifiers)
  • The IDs must correspond to existing blocked lead records in your workspace
  • You can unblock multiple leads in a single request
  • Once unblocked, leads can be added to campaigns and receive messages
  • This affects all campaigns in the workspace
  • This is a public route that requires API key authentication

​
Workflow Example

  1. Call GET /v1/blocked-leads to retrieve blocked leads and their IDs
  2. Identify which leads you want to unblock
  3. Call this endpoint with the array of IDs to remove them from the blocked list

Authorizations

​
x-api-key
string
header
required

API key for authentication. Generate from your WaLead dashboard.

Body

application/json

Array of blocked lead IDs to remove

Response

Leads unblocked successfully

​
success
boolean

Whether the operation was successful

​
message
string

Response message

​
unblocked
integer

Number of leads unblocked