Keep your Findymail exclusion list up to date

1. Findymail's Intellimatch page says you can upload a list of companies to exclude, such as current customers or past prospects, and Intellimatch removes them from results automatically.
2. Whoever owns prospecting collects the domains of new customers and closed prospects from the CRM or the billing tool, one source at a time.
3. They add the domains to the exclusion list in Findymail by hand. The page describes the upload but no schedule and no sync from a CRM.
4. A list can be shared with the team, but sharing needs a team plan, so a solo account keeps its lists private.

Add the domains of this month's new customers (acme.io, northwind.com, globex.co) to my Customers exclusion list in Findymail. Create the list if it does not exist, and skip domains that are already on it.

1. 01

   Find the list

   Your agent reads your lists with list_exclusion_lists and looks for the name in your prompt. Lists shared by your team come back too, with is_owner telling the agent which ones it may change. A list name is unique per user, so the agent never creates a second Customers list.

2. 02

   Create it only when missing

   If no list has that name, create_exclusion_list makes it, private unless you asked for it to be shared. Sharing fails on an account that is not on a team, and the agent then reports it instead of retrying.

3. 03

   Skip what is already there

   list_excluded_domains with the query filter and the list_id shows whether a domain is already on the list. The agent drops those from the batch and cleans the rest to bare domains, so acme.io stays acme.io and a pasted https://www.acme.io/pricing becomes acme.io.

4. 04

   Add the new domains

   add_excluded_domains sends the whole batch in one call, up to 10,000 domains. Findymail processes the first 50 at once and queues the rest in the background, so the reply can show fewer processed_immediately than total. Adding reaches nobody and can be undone, so it does not wait for your OK.

5. 05

   Report the list

   The agent returns how many domains were sent, how many were already there and the list ID, so you can use the same list in your next Intellimatch search.

Customers list (id 1204): 3 domains sent
Added: acme.io, northwind.com, globex.co
Already on the list: 0
Processed immediately: 3, queued: 0

curl -X POST https://cotlet.dev/api/v1/findymail/excluded-domains \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"list_id":1204,"domains":["acme.io","northwind.com","globex.co"]}'

{
  "success": true,
  "total": 3,
  "processed_immediately": 3,
  "queued": 0,
  "list_id": 1204
}

MCP: add https://cotlet.dev/mcp/v1 with the same key; the call is findymail_write → add_excluded_domains. Example data.

• Build a Findymail lead list from your ideal customer
• Findymail API and MCP server: every tool
• All use cases