{
 "schema_version": 1,
 "generated": "2026-10-31",
 "id": "gortexai-franco--import-a-contact-list-and-suppressions-from-csv",
 "repo": "GortexAI/franco",
 "repo_url": "https://github.com/GortexAI/franco",
 "repo_slug": "gortexai-franco",
 "title": "Import your contact and do-not-contact lists from CSV",
 "page_title": "How to import your contact and do-not-contact lists from CSV with Franco",
 "summary": "Bring existing spreadsheets into Franco and make sure suppressed addresses and domains are never emailed.",
 "who": "A sales lead moving an existing prospect spreadsheet and do-not-contact list into an automated tool.",
 "problem": "Typing contacts in one by one is slow, and a missed opt-out list can send mail to people who asked not to hear from you.",
 "outcome": "Contacts imported and checked row by row, with suppressions loaded before any campaign runs.",
 "steps": [
  "Get a template with `franco import --template --kind contacts > contacts.csv`",
  "Validate with `franco import contacts.csv --kind contacts --dry-run`; nothing is written",
  "Import and verify emails with `franco import contacts.csv --kind contacts --verify`",
  "Load your do-not-contact list with `franco suppress import do_not_contact.csv`",
  "Or use the Import CSV panel on the dashboard's Contacts tab"
 ],
 "agent_prompt": "Import <contacts.csv> into GortexAI/franco as contacts with a dry run first, report every rejected row and its reason, then load <do_not_contact.csv> as suppressions before importing for real.",
 "agents": [
  "any"
 ],
 "difficulty": "Beginner",
 "time": "20 minutes",
 "basis": "readme",
 "caveat": "--verify spends one verification credit per address that is not already marked verified.",
 "category": "Sales and marketing",
 "tags": [
  "Sales and marketing"
 ],
 "lang": "python",
 "requirements": [
  "Python 3.11 or newer",
  "Claude Code logged in on a Pro or Max plan, or an opt-in Codex runtime on a ChatGPT plan",
  "A mailbox to send from (Google Workspace recommended) and email verifier keys",
  "Chromium, installed with franco install, for LinkedIn and JavaScript-heavy sites"
 ],
 "risk": "sensitive",
 "seen_in_the_wild": false,
 "mentioned_publicly": false,
 "risks": [],
 "best": false,
 "score": 0.9,
 "evidence": [],
 "url": "https://dedupedai.com/use-cases/gortexai-franco/import-a-contact-list-and-suppressions-from-csv/",
 "md": "https://dedupedai.com/use-cases/gortexai-franco/import-a-contact-list-and-suppressions-from-csv/index.md",
 "disclaimer": "Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked \"Seen in the wild\", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email hello@dedupedai.com and we will look at it promptly.",
 "api": "https://dedupedai.com/api/v1/usecases/gortexai-franco--import-a-contact-list-and-suppressions-from-csv.json",
 "api_version": "v1"
}