instantly-data-handling

# Instantly Data Handling ## Overview Manage leads, lead lists, block lists, and regulatory compliance in Instantly API v2. Covers lead CRUD operations, list management, bulk import patterns, unsubscribe handling, GDPR right-to-deletion, CAN-SPAM compliance, and block list automation. Cold email has specific legal requirements — this skill ensures your integrations are compliant. ## Prerequisites - Completed `instantly-install-auth` setup - API key with `leads:all` scope - Understanding of CAN-SPAM / GDPR requirements for cold outreach ## Instructions ### Step 1: Lead List Management ```typescript import { InstantlyClient } from "./src/instantly/client"; const client = new InstantlyClient(); // Create a lead list (container for leads outside campaigns) async function createLeadList(name: string) { const list = await client.request<{ id: string; name: string }>("/lead-lists", { method: "POST", body: JSON.stringify({ name, has_enrichment_task: false, }), }); console.log(`Created list: ${list.name} (${list.id})`); return list; } // List all lead lists async function getLeadLists() { return client.request<Array<{ id: string; name: string; timestamp_created: string; }>>("/lead-lists?limit=50"); } // Delete a lead list async function deleteLeadList(listId: string) { await client.request(`/lead-lists/${listId}`, { method: "DELETE" }); } ``` ### Step 2: Lead Import with Validation ```typescript interface LeadImport { email: string; ...