---
title: "Findymail integration for LuumenAI"
url: "https://www.luumen.ai/integrations/findymail/"
entity: SoftwareIntegration
category: "Communication"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Findymail integration for LuumenAI

Look up verified contacts, check credits, and keep exclusion lists current

## What LuumenAI can do with Findymail

LuumenAI connects to Findymail with an API token and exposes 21 tools (13 read-only · 5 write · 3 destructive). Reads answer immediately; writes are shown as a plan and require approval by default, configurable per tool by an administrator.

## Key facts

- Authentication: API token
- Tools available: 21 tools (13 read-only · 5 write · 3 destructive)
- Plan: available on all plans
- Category: Communication

## About Findymail with LuumenAI

Connect Findymail and Luumen can look up verified emails by name and domain, run Intellimatch searches, read your contact lists, and check credit usage for you or the whole team. Changes — new contact lists, exclusion list edits, excluded domains — are previewed first and, by default, wait for your approval. Auth is a Findymail API key.

## Example tools

Read-only (13 in total):

- `FINDYMAIL_FIND_EMAIL_BY_NAME` — Find someone's email using their full name and company domain.
- `FINDYMAIL_GET_CONTACT_LISTS` — Retrieve all contact lists.
- `FINDYMAIL_GET_CREDITS` — Check available API credits for your Findymail account.
- `FINDYMAIL_GET_CREDITS_SUMMARY` — Retrieve credits usage summary report for the authenticated account.
- `FINDYMAIL_GET_CREDITS_TEAM_SUMMARY` — Retrieve team credits usage summary report.
- `FINDYMAIL_GET_EXCLUSION_LIST` — Retrieve a specific exclusion list by ID.
- `FINDYMAIL_GET_INTELLIMATCH_DATA` — Retrieve data from an Intellimatch search.
- `FINDYMAIL_GET_INTELLIMATCH_STATUS` — Check the status of an Intellimatch search job.

Write and destructive (8 in total, approval required by default):

- `FINDYMAIL_ADD_EXCLUDED_DOMAIN` — Add domains to an exclusion list in Findymail.
- `FINDYMAIL_CREATE_EXCLUSION_LIST` — Create a new exclusion list for Intellimatch searches.
- `FINDYMAIL_CREATE_LIST` — Create a new contact list.
- `FINDYMAIL_DELETE_EXCLUSION_LIST` — Permanently delete an exclusion list by its ID.
- `FINDYMAIL_DELETE_LIST` — Permanently deletes a contact list by its ID.
- `FINDYMAIL_REMOVE_EXCLUDED_DOMAIN` — Remove domains from the exclusion list.
- `FINDYMAIL_UPDATE_EXCLUSION_LIST` — Update an existing exclusion list.
- `FINDYMAIL_UPDATE_LIST` — Update an existing contact list.

## Frequently asked questions

### How does LuumenAI connect to Findymail?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in Findymail on its own?

Read actions answer immediately. Anything that writes is shown as a plan and requires approval by default, including the 3 actions classified as destructive. Administrators configure that per tool.

### Is there an audit trail?

Every call to Findymail — read or write, approved or declined — is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/findymail/