IN THIS ARTICLE:
Introduction to blacklisting domains
To avoid a risk of sending unwanted emails to the prospects from the same company, use our domain blacklisting endpoint. It will automatically block ongoing and future sending to all prospects within a given domain. Following endpoints are account specific. If you're interested in blacklisting emails and domains for all companies under your agency, check this article.
IMPORTANT: After blacklisting a domain those prospects may still remain as active in your prospect's database. But no worries - they will be automatically blacklisted as soon as there will be their turn to receive an email from you.
If you want to learn more about blacklisting domains, check this article.
GET domains
To get a list of all blacklisted domains from your account, use the following request:
GET https://api.woodpecker.co/rest/v2/blacklist/domains
Sample response:
{
"domains": [
"baddomain.com",
"blacklistedomain.io",
"nomoreemails.co",
"finisheddeal.co.uk",
"notmyicp.design"
]
"pagination_data": {
"total_elements": 501,
"total_pages": 6,
"current_page_number": 3,
"page_size": 100
}
}
Response data type:
domains - JSON object, list of all blacklisted domains.
POST domains
To blacklist domains in bulk via API, use the following request:
POST https://api.woodpecker.co/rest/v2/blacklist/domains
with the following request body:
{
"domains": [
"baddomain.com",
"blacklistedomain.io",
"nomoreemails.co",
"finisheddeal.co.uk",
"notmyicp.design"
]
}
If your request is successful, you'll get the following response:
{
"domains": [
"baddomain.com",
"blacklistedomain.io",
"nomoreemails.co"
],
"status": {
"status": "OK",
"code": "OK",
"msg": "Domains were added to blacklist successfully."
}
} DELETE domains
To remove domains from blacklist via API, use the following request:
DELETE https://api.woodpecker.co/rest/v2/blacklist/domains
with the following request body which includes all domains you want to remove from blacklist:
{
"domains": [
"baddomain.com",
"blacklistedomain.io",
"nomoreemails.co",
"finisheddeal.co.uk",
"notmyicp.design"
]
}
If your request is successful, you'll get the 200 OK status.
Want to integrate with us?
If you're interested in building a native integration with Woodpecker, fill out this form and we'll get back to you.