Blacklisting domains
How to blacklist domains via Woodpecker API 2.0
Anna Nowacka avatar
Written by Anna Nowacka
Updated over a week ago

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"
]
}

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.

Did this answer your question?