Delete domains from the agency blacklist

Remove specific domains from the agency blacklist. Removing a domain from the list doesn't change the status of a prospects if it was previously set to BLACKLISTED

Request

Endpoint

DELETE https://api.woodpecker.co/rest/v2/agency/blacklist/domains

Headers

x-api-key: {YOUR_API_KEY}
Content-type: application/json

For details on how to authenticate your requests, please see the authentication guide.

Body

info

You can remove up to 500 domains per request

{
  "domains": [
    "baddomain.com", 
    "blacklistedomain.io", 
    "nomoreemails.co"
  ]
}

Field	Type	Description
domains	array[string]	List of domains to remove from blacklist

Request samples

Remove a list of domains from blacklist

cURL

curl --request DELETE \ 
  --url "https://api.woodpecker.co/rest/v2/agency/blacklist/domains" \
  --header "x-api-key: {YOUR_API_KEY}" \
  --header "Content-Type: application/json" \
  --data '{
    "domains": [
      "baddomain.com",
      "blacklistedomain.io",
      "nomoreemails.co"
    ]
  }'

Python

import requests

def delete_blacklist_domains():
  url = "https://api.woodpecker.co/rest/v2/agency/blacklist/domains"
  headers = {
    "x-api-key": "{YOUR_API_KEY}",
    "Content-Type": "application/json"
  }
  payload = {
    "domains": [
      "baddomain.com",
      "blacklistedomain.io",
      "nomoreemails.co"
    ]
  }
  
  response = requests.delete(url, headers=headers, json=payload)
  if response.status_code == 200:
    return response.json()
  else:
    raise Exception(f"DELETE request failed: {response.status_code}, {response.text}")

if __name__ == "__main__":
  try:
    data = delete_blacklist_domains()
    print("DELETE response:", data)
  except Exception as e:
    print("Error:", e)

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class WoodpeckerApiClient {
  private static final String API_KEY = "{YOUR_API_KEY}";
  private static final String URL = "https://api.woodpecker.co/rest/v2/agency/blacklist/domains";

  public static void main(String[] args) {
    try {
      HttpClient client = HttpClient.newHttpClient();
      String jsonPayload = "{\"domains\": [\"baddomain.com\", \"blacklistedomain.io\", \"nomoreemails.co\"]}";
      
      HttpRequest request = HttpRequest.newBuilder()
        .uri(new URI(URL))
        .header("Content-Type", "application/json")
        .header("x-api-key", API_KEY)
        .method("DELETE", HttpRequest.BodyPublishers.ofString(jsonPayload))
        .build();

      HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
      
      if (response.statusCode() == 200) {
        System.out.println("DELETE response: " + response.body());
      } else {
        System.err.println("DELETE request failed: " + response.statusCode());
      }
    } catch (Exception e) {
      e.printStackTrace();
    }
  }
}

Node.js

const axios = require('axios');

async function deleteBlacklistDomains() {
  const url = 'https://api.woodpecker.co/rest/v2/agency/blacklist/domains';
  const headers = {
    'x-api-key': '{YOUR_API_KEY}',
    'Content-Type': 'application/json'
  };
  const data = {
    domains: [
      'baddomain.com',
      'blacklistedomain.io',
      'nomoreemails.co'
    ]
  };

  try {
    const response = await axios.delete(url, { headers, data });
    if (response.status === 200) {
      console.log('DELETE response:', response.data);
    } else {
      console.error('DELETE request failed:', response.status);
    }
  } catch (error) {
    console.error('DELETE request failed:', error.response ? error.response.status : error.message);
  }
}

deleteBlacklistDomains();

PHP

<?php
require 'vendor/autoload.php';

use GuzzleHttp\Client;
use GuzzleHttp\Exception\RequestException;

$client = new Client([
  'base_uri' => 'https://api.woodpecker.co/rest/v2/',
  'headers'  => ['x-api-key' => getenv('WOODPECKER_API_KEY')],
]);

try {
  $response = $client->delete('agency/blacklist/domains', [
    'json' => [
      'domains' => [
        'baddomain.com',
        'blacklistedomain.io',
        'nomoreemails.co',
      ],
    ],
  ]);
  echo $response->getStatusCode(), "\n";
  echo $response->getBody(), "\n";
} catch (RequestException $e) {
  echo "Error: ", $e->getMessage(), "\n";
  if ($e->hasResponse()) {
    echo $e->getResponse()->getBody(), "\n";
  }
}

Response

Response examples

200

Returns a list of successfully removed domains, including only those that were previously blacklisted; domains not found in the blacklist or with an invalid format are ignored and not included in the response. If none of the requested domains were blacklisted, the returned array will be empty.

{
  "domains": [
    "baddomain.com", 
    "blacklistedomain.io", 
    "nomoreemails.co"
  ]
}

Body schema

Field	Type	Description
domains	array[string]	List of domains removed from the blacklist

400

Invalid request or malformed request syntax.

{
  "title": "Bad Request",
  "status": 400,
  "detail": "You can proceed with up to 500 elements in one request" | "Domains parameter can not be empty" | "Value of domains is incorrect.",
  "timestamp": "2025-03-05 17:57:00"
}

Body schema

Field	Type	Description
title	string	A short title describing the error
status	integer	The HTTP status code
detail	string	A detailed message explaining the error
timestamp	string	The timestamp when the error occurred, YYYY-MM-DD HH:MM:SS UTC

401

An issue with authorization. Please review the authorization guide

{
  "title": "Unauthorized",
  "status": 401,
  "detail": "Invalid api key",
  "timestamp": "2025-03-05 17:57:00"
}

Body schema

Field	Type	Description
title	string	A short title describing the error
status	integer	The HTTP status code
detail	string	A detailed message explaining the error
timestamp	string	The timestamp when the error occurred, YYYY-MM-DD HH:MM:SS UTC

404

Please review the request URL.

{
  "title": "Not Found",
  "status": 404,
  "detail": "Requested resource does not exist",
  "timestamp": "2025-03-05 17:57:00"
}

Body schema

Field	Type	Description
title	string	A short title describing the error
status	integer	The HTTP status code
detail	string	A detailed message explaining the error
timestamp	string	The timestamp when the error occurred, YYYY-MM-DD HH:MM:SS UTC

500

Unexpected error, please try again later

{
  "title": "Internal server error",
  "status": 500,
  "detail": "An unexpected error has occurred. Please try again later.",
  "timestamp": "2025-03-05 17:57:00"
}

Body schema

Field	Type	Description
title	string	A short title describing the error
status	integer	The HTTP status code
detail	string	A detailed message explaining the error
timestamp	string	The timestamp when the error occurred, YYYY-MM-DD HH:MM:SS UTC