[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M791MPH330VKEF4W75XTWBFW":3,"skill-same:01M791MPH330VKEF4W75XTWBFW":59},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":36,"commitSha":37,"skillDirectory":38,"forksCount":39,"repositoryHtmlUrl":40,"repositoryHomepageUrl":6,"ownerHtmlUrl":41,"ownerBlogUrl":42,"ownerDescription":43,"updatedAt":44,"install":45,"resources":58},"01M791MPH330VKEF4W75XTWBFW","instantly-data-handling",null,"Implement Instantly.ai lead data management, GDPR\u002FCAN-SPAM compliance, and list operations.\nUse when handling lead imports, managing block lists, implementing unsubscribe flows,\nor ensuring compliance with email regulations.\nTrigger with phrases like \"instantly leads\", \"instantly data\", \"instantly GDPR\",\n\"instantly block list\", \"instantly lead management\", \"instantly unsubscribe\".","jukeyman\u002Fjukeyman-skills","jukeyman","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F142960420?v=4","01M78FR4Y3DHMMCBCC0GXXNB3F","RICK JEFFERSON","01M78FR4Z8RVQRAD31Y5J7V6EB",1,"MIT","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fsaas-packs--instantly-pack--instantly-data-handling\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: instantly-data-handling\ndescription: |\n  Implement Instantly.ai lead data management, GDPR\u002FCAN-SPAM compliance, and list operations.\n  Use when handling lead imports, managing block lists, implementing unsubscribe flows,\n  or ensuring compliance with email regulations.\n  Trigger with phrases like \"instantly leads\", \"instantly data\", \"instantly GDPR\",\n  \"instantly block list\", \"instantly lead management\", \"instantly unsubscribe\".\nallowed-tools: Read, Write, Edit, Bash(npm:*), Bash(curl:*), Grep\nversion: 1.0.0\nlicense: MIT\nauthor: Jeremy Longshore \u003Cjeremy@intentsolutions.io>\ncompatible-with: claude-code, codex, openclaw\ntags: [saas, instantly, data-handling, gdpr, compliance, leads]\n---\n# Instantly Data Handling\n\n## Overview\nManage 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.\n\n## Prerequisites\n- Completed `instantly-install-auth` setup\n- API key with `leads:all` scope\n- Understanding of CAN-SPAM \u002F GDPR requirements for cold outreach\n\n## Instructions\n\n### Step 1: Lead List Management\n```typescript\nimport { InstantlyClient } from \".\u002Fsrc\u002Finstantly\u002Fclient\";\nconst client = new InstantlyClient();\n\n\u002F\u002F Create a lead list (container for leads outside campaigns)\nasync function createLeadList(name: string) {\n  const list = await client.request\u003C{ id: string; name: string }>(\"\u002Flead-lists\", {\n    method: \"POST\",\n    body: JSON.stringify({\n      name,\n      has_enrichment_task: false,\n    }),\n  });\n  console.log(`Created list: ${list.name} (${list.id})`);\n  return list;\n}\n\n\u002F\u002F List all lead lists\nasync function getLeadLists() {\n  return client.request\u003CArray\u003C{\n    id: string; name: string; timestamp_created: string;\n  }>>(\"\u002Flead-lists?limit=50\");\n}\n\n\u002F\u002F Delete a lead list\nasync function deleteLeadList(listId: string) {\n  await client.request(`\u002Flead-lists\u002F${listId}`, { method: \"DELETE\" });\n}\n```\n\n### Step 2: Lead Import with Validation\n```typescript\ninterface LeadImport {\n  email: string;\n  first_name?: string;\n  last_name?: string;\n  company_name?: string;\n  website?: string;\n  phone?: string;\n  custom_variables?: Record\u003Cstring, string>;\n}\n\nasync function importLeads(\n  campaignId: string,\n  leads: LeadImport[],\n  options = { skipDuplicates: true, verifyEmails: true }\n) {\n  const results = { added: 0, skipped: 0, failed: 0, errors: [] as string[] };\n\n  for (const lead of leads) {\n    try {\n      \u002F\u002F Validate email format\n      if (!lead.email || !\u002F^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$\u002F.test(lead.email)) {\n        results.failed++;\n        results.errors.push(`Invalid email: ${lead.email}`);\n        continue;\n      }\n\n      \u002F\u002F Check against block list patterns\n      const domain = lead.email.split(\"@\")[1];\n      if (BLOCKED_PATTERNS.some((p) => domain.includes(p))) {\n        results.skipped++;\n        continue;\n      }\n\n      await client.request(\"\u002Fleads\", {\n        method: \"POST\",\n        body: JSON.stringify({\n          campaign: campaignId,\n          email: lead.email,\n          first_name: lead.first_name,\n          last_name: lead.last_name,\n          company_name: lead.company_name,\n          website: lead.website,\n          phone: lead.phone,\n          custom_variables: lead.custom_variables,\n          skip_if_in_workspace: options.skipDuplicates,\n          skip_if_in_campaign: true,\n          verify_leads_on_import: options.verifyEmails,\n        }),\n      });\n      results.added++;\n    } catch (e: any) {\n      results.failed++;\n      results.errors.push(`${lead.email}: ${e.message}`);\n    }\n  }\n\n  console.log(`Import: ${results.added} added, ${results.skipped} skipped, ${results.failed} failed`);\n  return results;\n}\n\n\u002F\u002F Role-based emails and internal domains to always skip\nconst BLOCKED_PATTERNS = [\n  \"noreply\", \"no-reply\", \"donotreply\",\n  \"info@\", \"admin@\", \"support@\", \"help@\", \"abuse@\",\n  \"postmaster@\", \"webmaster@\", \"hostmaster@\",\n];\n```\n\n### Step 3: Lead Operations (Move, Update, Delete)\n```typescript\n\u002F\u002F Move leads between campaigns or lists\nasync function moveLeads(opts: {\n  fromCampaign?: string;\n  fromList?: string;\n  toCampaign?: string;\n  toList?: string;\n  limit?: number;\n}) {\n  return client.request(\"\u002Fleads\u002Fmove\", {\n    method: \"POST\",\n    body: JSON.stringify({\n      in_campaign: opts.fromCampaign,\n      in_list: opts.fromList,\n      to_campaign_id: opts.toCampaign,\n      to_list_id: opts.toList,\n      limit: opts.limit || 1000,\n      check_duplicates: true,\n    }),\n  });\n}\n\n\u002F\u002F Update lead interest status\nasync function updateLeadInterest(\n  email: string,\n  campaignId: string,\n  status: \"interested\" | \"not_interested\" | \"meeting_booked\" | \"closed\"\n) {\n  const interestMap: Record\u003Cstring, number> = {\n    interested: 1,\n    not_interested: -1,\n    meeting_booked: 2,\n    closed: 3,\n  };\n\n  await client.request(\"\u002Fleads\u002Fupdate-interest-status\", {\n    method: \"POST\",\n    body: JSON.stringify({\n      lead_email: email,\n      campaign_id: campaignId,\n      interest_value: interestMap[status],\n    }),\n  });\n}\n\n\u002F\u002F Update lead data\nasync function updateLead(leadId: string, data: Partial\u003CLeadImport>) {\n  await client.request(`\u002Fleads\u002F${leadId}`, {\n    method: \"PATCH\",\n    body: JSON.stringify(data),\n  });\n}\n\n\u002F\u002F Delete leads from a campaign (bulk)\nasync function deleteLeadsFromCampaign(campaignId: string, status?: number) {\n  await client.request(\"\u002Fleads\", {\n    method: \"DELETE\",\n    body: JSON.stringify({\n      campaign_id: campaignId,\n      status, \u002F\u002F e.g., -1 for bounced only\n    }),\n  });\n}\n```\n\n### Step 4: Block List Management\n```typescript\n\u002F\u002F Add entries to workspace block list\nasync function addToBlockList(entries: string[]) {\n  \u002F\u002F Single entry\n  for (const entry of entries) {\n    await client.request(\"\u002Fblock-lists-entries\", {\n      method: \"POST\",\n      body: JSON.stringify({ bl_value: entry }), \u002F\u002F email or domain\n    });\n  }\n\n  \u002F\u002F Or bulk add\n  await client.request(\"\u002Fblock-lists-entries\u002Fbulk-create\", {\n    method: \"POST\",\n    body: JSON.stringify({ entries }),\n  });\n}\n\n\u002F\u002F Seed block list with standard entries\nasync function seedBlockList() {\n  const standardBlocks = [\n    \u002F\u002F Your own domains\n    \"yourdomain.com\",\n    \"yourcompany.com\",\n    \u002F\u002F Competitor domains\n    \"competitor1.com\",\n    \"competitor2.com\",\n    \u002F\u002F ISP domains (not your target audience)\n    \"gmail.com\",      \u002F\u002F uncomment if B2B only\n    \"yahoo.com\",\n    \"hotmail.com\",\n    \"outlook.com\",\n    \u002F\u002F Trap\u002Fspamtrap domains\n    \"spamtrap.com\",\n  ];\n\n  await addToBlockList(standardBlocks);\n  console.log(`Seeded block list with ${standardBlocks.length} entries`);\n}\n\n\u002F\u002F List and audit block list\nasync function auditBlockList() {\n  const entries = await client.request\u003CArray\u003C{\n    id: string; bl_value: string;\n  }>>(\"\u002Fblock-lists-entries?limit=100\");\n  console.log(`Block list: ${entries.length} entries`);\n  for (const e of entries) {\n    console.log(`  ${e.bl_value}`);\n  }\n}\n```\n\n### Step 5: GDPR \u002F CAN-SPAM Compliance\n```typescript\n\u002F\u002F GDPR: Right to deletion — remove lead from everywhere\nasync function handleDeletionRequest(email: string) {\n  console.log(`Processing GDPR deletion request for: ${email}`);\n\n  \u002F\u002F 1. Find all campaigns containing this lead\n  const campaigns = await client.request\u003CArray\u003C{ id: string }>>(\n    `\u002Fcampaigns\u002Fsearch-by-contact?search=${encodeURIComponent(email)}`\n  );\n\n  \u002F\u002F 2. Delete lead from each campaign\n  for (const campaign of campaigns) {\n    const leads = await client.leads.list({ campaign: campaign.id });\n    const matchingLead = leads.find((l) => l.email === email);\n    if (matchingLead) {\n      await client.leads.delete(matchingLead.id);\n      console.log(`  Deleted from campaign ${campaign.id}`);\n    }\n  }\n\n  \u002F\u002F 3. Add to workspace block list (prevent re-import)\n  await addToBlockList([email]);\n  console.log(`  Added to block list`);\n\n  \u002F\u002F 4. Log for compliance records\n  console.log(`  Deletion complete. Log this for GDPR records.`);\n}\n\n\u002F\u002F CAN-SPAM: Ensure unsubscribe is honored\nasync function handleUnsubscribe(email: string) {\n  \u002F\u002F 1. Add to block list (global across all campaigns)\n  await addToBlockList([email]);\n\n  \u002F\u002F 2. Also add the domain if it's a business-wide request\n  \u002F\u002F const domain = email.split(\"@\")[1];\n  \u002F\u002F await addToBlockList([domain]);\n\n  console.log(`Unsubscribe processed: ${email} added to global block list`);\n}\n\n\u002F\u002F Email verification before import\nasync function verifyEmail(email: string) {\n  \u002F\u002F Start verification\n  await client.request(\"\u002Femail-verification\", {\n    method: \"POST\",\n    body: JSON.stringify({\n      email,\n      webhook_url: \"https:\u002F\u002Fapi.yourapp.com\u002Fwebhooks\u002Fverification\",\n    }),\n  });\n\n  \u002F\u002F Check status (may need to poll)\n  const result = await client.request\u003C{\n    email: string; status: string; reason: string;\n  }>(`\u002Femail-verification\u002F${encodeURIComponent(email)}`);\n\n  return result;\n}\n```\n\n## Key API Endpoints\n| Method | Path | Purpose |\n|--------|------|---------|\n| `POST` | `\u002Fleads` | Create lead |\n| `POST` | `\u002Fleads\u002Flist` | List\u002Ffilter leads |\n| `PATCH` | `\u002Fleads\u002F{id}` | Update lead |\n| `DELETE` | `\u002Fleads\u002F{id}` | Delete single lead |\n| `DELETE` | `\u002Fleads` | Bulk delete leads |\n| `POST` | `\u002Fleads\u002Fmove` | Move leads between campaigns\u002Flists |\n| `POST` | `\u002Fleads\u002Fupdate-interest-status` | Update interest status |\n| `POST` | `\u002Flead-lists` | Create lead list |\n| `GET` | `\u002Flead-lists` | List lead lists |\n| `POST` | `\u002Fblock-lists-entries` | Add block list entry |\n| `POST` | `\u002Fblock-lists-entries\u002Fbulk-create` | Bulk add entries |\n| `POST` | `\u002Femail-verification` | Verify email |\n| `GET` | `\u002Fcampaigns\u002Fsearch-by-contact` | Find campaigns by lead |\n\n## Error Handling\n| Error | Cause | Solution |\n|-------|-------|----------|\n| `422` on lead create | Duplicate in workspace | Use `skip_if_in_workspace: true` |\n| Lead not found in campaign | Already deleted or moved | Search across campaigns first |\n| Block list full | Too many entries | Remove outdated entries periodically |\n| Email verification timeout | External service delay | Poll status endpoint |\n\n## Resources\n- [Instantly Lead API](https:\u002F\u002Fdeveloper.instantly.ai\u002Fapi\u002Fv2\u002Flead\u002Flistleads)\n- [Instantly Block List API](https:\u002F\u002Fdeveloper.instantly.ai\u002Fapi\u002Fv2\u002Fschemas)\n- [CAN-SPAM Requirements](https:\u002F\u002Fwww.ftc.gov\u002Fbusiness-guidance\u002Fresources\u002Fcan-spam-act-compliance-guide-business)\n\n## Next Steps\nFor workspace access control, see `instantly-enterprise-rbac`.\n","# Instantly Data Handling\n\n## Overview\nManage 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.\n\n## Prerequisites\n- Completed `instantly-install-auth` setup\n- API key with `leads:all` scope\n- Understanding of CAN-SPAM \u002F GDPR requirements for cold outreach\n\n## Instructions\n\n### Step 1: Lead List Management\n```typescript\nimport { InstantlyClient } from \".\u002Fsrc\u002Finstantly\u002Fclient\";\nconst client = new InstantlyClient();\n\n\u002F\u002F Create a lead list (container for leads outside campaigns)\nasync function createLeadList(name: string) {\n  const list = await client.request\u003C{ id: string; name: string }>(\"\u002Flead-lists\", {\n    method: \"POST\",\n    body: JSON.stringify({\n      name,\n      has_enrichment_task: false,\n    }),\n  });\n  console.log(`Created list: ${list.name} (${list.id})`);\n  return list;\n}\n\n\u002F\u002F List all lead lists\nasync function getLeadLists() {\n  return client.request\u003CArray\u003C{\n    id: string; name: string; timestamp_created: string;\n  }>>(\"\u002Flead-lists?limit=50\");\n}\n\n\u002F\u002F Delete a lead list\nasync function deleteLeadList(listId: string) {\n  await client.request(`\u002Flead-lists\u002F${listId}`, { method: \"DELETE\" });\n}\n```\n\n### Step 2: Lead Import with Validation\n```typescript\ninterface LeadImport {\n  email: string;\n  first_name?: string;\n  last_name?: string;\n  company_name?: string;\n  website?: string;\n  phone?: string;\n  custom_variables?: Record\u003Cstring, string>;\n}\n\nasync function importLeads(\n  campaignId: string,\n  leads: LeadImport[],\n  options = { skipDuplicates: true, verifyEmails: true }\n) {\n  const results = { added: 0, skipped: 0, failed: 0, errors: [] as string[] };\n\n  for (const lead of leads) {\n    try {\n      \u002F\u002F Validate email format\n      if (!lead.email || !\u002F^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$\u002F.test(lead.email)) {\n        results.failed++;\n        results.errors.push(`Invalid email: ${lead.email}`);\n        continue;\n      }\n\n      \u002F\u002F Check against block list patterns\n      const domain = lead.email.split(\"@\")[1];\n      if (BLOCKED_PATTERNS.some((p) => domain.includes(p))) {\n        results.skipped++;\n        continue;\n      }\n\n      await client.request(\"\u002Fleads\", {\n        method: \"POST\",\n        body: JSON.stringify({\n          campaign: campaignId,\n          email: lead.email,\n          first_name: lead.first_name,\n          last_name: lead.last_name,\n          company_name: lead.company_name,\n          website: lead.website,\n          phone: lead.phone,\n          custom_variables: lead.custom_variables,\n          skip_if_in_workspace: options.skipDuplicates,\n          skip_if_in_campaign: true,\n          verify_leads_on_import: options.verifyEmails,\n        }),\n      });\n      results.added++;\n    } catch (e: any) {\n      results.failed++;\n      results.errors.push(`${lead.email}: ${e.message}`);\n    }\n  }\n\n  console.log(`Import: ${results.added} added, ${results.skipped} skipped, ${results.failed} failed`);\n  return results;\n}\n\n\u002F\u002F Role-based emails and internal domains to always skip\nconst BLOCKED_PATTERNS = [\n  \"noreply\", \"no-reply\", \"donotreply\",\n  \"info@\", \"admin@\", \"support@\", \"help@\", \"abuse@\",\n  \"postmaster@\", \"webmaster@\", \"hostmaster@\",\n];\n```\n\n### Step 3: Lead Operations (Move, Update, Delete)\n```typescript\n\u002F\u002F Move leads between campaigns or lists\nasync function moveLeads(opts: {\n  fromCampaign?: string;\n  fromList?: string;\n  toCampaign?: string;\n  toList?: string;\n  limit?: number;\n}) {\n  return client.request(\"\u002Fleads\u002Fmove\", {\n    method: \"POST\",\n    body: JSON.stringify({\n      in_campaign: opts.fromCampaign,\n      in_list: opts.fromList,\n      to_campaign_id: opts.toCampaign,\n      to_list_id: opts.toList,\n      limit: opts.limit || 1000,\n      check_duplicates: true,\n    }),\n  });\n}\n\n\u002F\u002F Update lead interest status\nasync function updateLeadInterest(\n  email: string,\n  campaignId: string,\n  status: \"interested\" | \"not_interested\" | \"meeting_booked\" | \"closed\"\n) {\n  const interestMap: Record\u003Cstring, number> = {\n    interested: 1,\n    not_interested: -1,\n    meeting_booked: 2,\n    closed: 3,\n  };\n\n  await client.request(\"\u002Fleads\u002Fupdate-interest-status\", {\n    method: \"POST\",\n    body: JSON.stringify({\n      lead_email: email,\n      campaign_id: campaignId,\n      interest_value: interestMap[status],\n    }),\n  });\n}\n\n\u002F\u002F Update lead data\nasync function updateLead(leadId: string, data: Partial\u003CLeadImport>) {\n  await client.request(`\u002Fleads\u002F${leadId}`, {\n    method: \"PATCH\",\n    body: JSON.stringify(data),\n  });\n}\n\n\u002F\u002F Delete leads from a campaign (bulk)\nasync function deleteLeadsFromCampaign(campaignId: string, status?: number) {\n  await client.request(\"\u002Fleads\", {\n    method: \"DELETE\",\n    body: JSON.stringify({\n      campaign_id: campaignId,\n      status, \u002F\u002F e.g., -1 for bounced only\n    }),\n  });\n}\n```\n\n### Step 4: Block List Management\n```typescript\n\u002F\u002F Add entries to workspace block list\nasync function addToBlockList(entries: string[]) {\n  \u002F\u002F Single entry\n  for (const entry of entries) {\n    await client.request(\"\u002Fblock-lists-entries\", {\n      method: \"POST\",\n      body: JSON.stringify({ bl_value: entry }), \u002F\u002F email or domain\n    });\n  }\n\n  \u002F\u002F Or bulk add\n  await client.request(\"\u002Fblock-lists-entries\u002Fbulk-create\", {\n    method: \"POST\",\n    body: JSON.stringify({ entries }),\n  });\n}\n\n\u002F\u002F Seed block list with standard entries\nasync function seedBlockList() {\n  const standardBlocks = [\n    \u002F\u002F Your own domains\n    \"yourdomain.com\",\n    \"yourcompany.com\",\n    \u002F\u002F Competitor domains\n    \"competitor1.com\",\n    \"competitor2.com\",\n    \u002F\u002F ISP domains (not your target audience)\n    \"gmail.com\",      \u002F\u002F uncomment if B2B only\n    \"yahoo.com\",\n    \"hotmail.com\",\n    \"outlook.com\",\n    \u002F\u002F Trap\u002Fspamtrap domains\n    \"spamtrap.com\",\n  ];\n\n  await addToBlockList(standardBlocks);\n  console.log(`Seeded block list with ${standardBlocks.length} entries`);\n}\n\n\u002F\u002F List and audit block list\nasync function auditBlockList() {\n  const entries = await client.request\u003CArray\u003C{\n    id: string; bl_value: string;\n  }>>(\"\u002Fblock-lists-entries?limit=100\");\n  console.log(`Block list: ${entries.length} entries`);\n  for (const e of entries) {\n    console.log(`  ${e.bl_value}`);\n  }\n}\n```\n\n### Step 5: GDPR \u002F CAN-SPAM Compliance\n```typescript\n\u002F\u002F GDPR: Right to deletion — remove lead from everywhere\nasync function handleDeletionRequest(email: string) {\n  console.log(`Processing GDPR deletion request for: ${email}`);\n\n  \u002F\u002F 1. Find all campaigns containing this lead\n  const campaigns = await client.request\u003CArray\u003C{ id: string }>>(\n    `\u002Fcampaigns\u002Fsearch-by-contact?search=${encodeURIComponent(email)}`\n  );\n\n  \u002F\u002F 2. Delete lead from each campaign\n  for (const campaign of campaigns) {\n    const leads = await client.leads.list({ campaign: campaign.id });\n    const matchingLead = leads.find((l) => l.email === email);\n    if (matchingLead) {\n      await client.leads.delete(matchingLead.id);\n      console.log(`  Deleted from campaign ${campaign.id}`);\n    }\n  }\n\n  \u002F\u002F 3. Add to workspace block list (prevent re-import)\n  await addToBlockList([email]);\n  console.log(`  Added to block list`);\n\n  \u002F\u002F 4. Log for compliance records\n  console.log(`  Deletion complete. Log this for GDPR records.`);\n}\n\n\u002F\u002F CAN-SPAM: Ensure unsubscribe is honored\nasync function handleUnsubscribe(email: string) {\n  \u002F\u002F 1. Add to block list (global across all campaigns)\n  await addToBlockList([email]);\n\n  \u002F\u002F 2. Also add the domain if it's a business-wide request\n  \u002F\u002F const domain = email.split(\"@\")[1];\n  \u002F\u002F await addToBlockList([domain]);\n\n  console.log(`Unsubscribe processed: ${email} added to global block list`);\n}\n\n\u002F\u002F Email verification before import\nasync function verifyEmail(email: string) {\n  \u002F\u002F Start verification\n  await client.request(\"\u002Femail-verification\", {\n    method: \"POST\",\n    body: JSON.stringify({\n      email,\n      webhook_url: \"https:\u002F\u002Fapi.yourapp.com\u002Fwebhooks\u002Fverification\",\n    }),\n  });\n\n  \u002F\u002F Check status (may need to poll)\n  const result = await client.request\u003C{\n    email: string; status: string; reason: string;\n  }>(`\u002Femail-verification\u002F${encodeURIComponent(email)}`);\n\n  return result;\n}\n```\n\n## Key API Endpoints\n| Method | Path | Purpose |\n|--------|------|---------|\n| `POST` | `\u002Fleads` | Create lead |\n| `POST` | `\u002Fleads\u002Flist` | List\u002Ffilter leads |\n| `PATCH` | `\u002Fleads\u002F{id}` | Update lead |\n| `DELETE` | `\u002Fleads\u002F{id}` | Delete single lead |\n| `DELETE` | `\u002Fleads` | Bulk delete leads |\n| `POST` | `\u002Fleads\u002Fmove` | Move leads between campaigns\u002Flists |\n| `POST` | `\u002Fleads\u002Fupdate-interest-status` | Update interest status |\n| `POST` | `\u002Flead-lists` | Create lead list |\n| `GET` | `\u002Flead-lists` | List lead lists |\n| `POST` | `\u002Fblock-lists-entries` | Add block list entry |\n| `POST` | `\u002Fblock-lists-entries\u002Fbulk-create` | Bulk add entries |\n| `POST` | `\u002Femail-verification` | Verify email |\n| `GET` | `\u002Fcampaigns\u002Fsearch-by-contact` | Find campaigns by lead |\n\n## Error Handling\n| Error | Cause | Solution |\n|-------|-------|----------|\n| `422` on lead create | Duplicate in workspace | Use `skip_if_in_workspace: true` |\n| Lead not found in campaign | Already deleted or moved | Search across campaigns first |\n| Block list full | Too many entries | Remove outdated entries periodically |\n| Email verification timeout | External service delay | Poll status endpoint |\n\n## Resources\n- [Instantly Lead API](https:\u002F\u002Fdeveloper.instantly.ai\u002Fapi\u002Fv2\u002Flead\u002Flistleads)\n- [Instantly Block List API](https:\u002F\u002Fdeveloper.instantly.ai\u002Fapi\u002Fv2\u002Fschemas)\n- [CAN-SPAM Requirements](https:\u002F\u002Fwww.ftc.gov\u002Fbusiness-guidance\u002Fresources\u002Fcan-spam-act-compliance-guide-business)\n\n## Next Steps\nFor workspace access control, see `instantly-enterprise-rbac`.\n",{"name":5,"tags":24,"author":31,"license":15,"version":32,"description":33,"allowed-tools":34,"compatible-with":35},[25,26,27,28,29,30],"saas","instantly","data-handling","gdpr","compliance","leads","Jeremy Longshore \u003Cjeremy@intentsolutions.io>","1.0.0","Implement Instantly.ai lead data management, GDPR\u002FCAN-SPAM compliance, and list operations.\nUse when handling lead imports, managing block lists, implementing unsubscribe flows,\nor ensuring compliance with email regulations.\nTrigger with phrases like \"instantly leads\", \"instantly data\", \"instantly GDPR\",\n\"instantly block list\", \"instantly lead management\", \"instantly unsubscribe\".\n","Read, Write, Edit, Bash(npm:*), Bash(curl:*), Grep","claude-code, codex, openclaw","main","99825ad3f3bcc6597ddcc7294a14e6e922f2b67b","skills\u002Fsaas-packs--instantly-pack--instantly-data-handling",0,"https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills","https:\u002F\u002Fgithub.com\u002Fjukeyman","https:\u002F\u002FRJBUSINESSSOLUTIONS.ORG","Credit and Finance Expert | Developer\r\n\r\nI'm Rick Jefferson, a seasoned credit and finance expert with over a decade of experience in financial literacy,","2026-07-13 07:03:29",{"source":8,"skillName":5,"commands":46,"prompt":56,"zipAvailable":57},[47,50,53],{"tool":48,"command":49},"npx","npx skills add jukeyman\u002Fjukeyman-skills --skill instantly-data-handling",{"tool":51,"command":52},"bunx","bunx skills add jukeyman\u002Fjukeyman-skills --skill instantly-data-handling",{"tool":54,"command":55},"pnpm","pnpm dlx skills add jukeyman\u002Fjukeyman-skills --skill instantly-data-handling","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fsaas-packs--instantly-pack--instantly-data-handling\u002FSKILL.md",true,[],[60,67,74,81,88,96],{"skillNo":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":19},"01M79ANS2SM329NEP5ZCX106RR","zustand-store-creator","Create zustand store creator operations. Auto-activating skill for Frontend Development.\nTriggers on: zustand store creator, zustand store creator\nPart of the Frontend Development skill category. Use when working with zustand store creator functionality. Trigger with phrases like \"zustand store creator\", \"zustand creator\", \"zustand\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzustand-store-creator\u002FSKILL.md",[],[],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":19},"01M79AMZKP4YDEZ7EHG1Y7PP74","zero-trust-config-helper","Configure with zero trust config helper operations. Auto-activating skill for Security Advanced.\nTriggers on: zero trust config helper, zero trust config helper\nPart of the Security Advanced skill category. Use when configuring systems or services. Trigger with phrases like \"zero trust config helper\", \"zero helper\", \"zero\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzero-trust-config-helper\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":19},"01M79AMJSBCEJQNBTYNAHYN5HM","zapier-integration-helper","Assist with zapier integration helper operations. Auto-activating skill for Business Automation.\nTriggers on: zapier integration helper, zapier integration helper\nPart of the Business Automation skill category. Use when working with APIs or building integrations. Trigger with phrases like \"zapier integration helper\", \"zapier helper\", \"zapier\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzapier-integration-helper\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":19},"01M79AHJZGVMARS13VFQYRR1MP","yaml-config-validator","Validate yaml config validator operations. Auto-activating skill for DevOps Basics.\nTriggers on: yaml config validator, yaml config validator\nPart of the DevOps Basics skill category. Use when configuring systems or services. Trigger with phrases like \"yaml config validator\", \"yaml validator\", \"yaml\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fyaml-config-validator\u002FSKILL.md",[],[],{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":92,"sourceHtmlUrl":93,"categories":94,"keywords":95,"publishedAt":19},"01M79AHGDZRN0020RDQSQDPAM8","xvary-stock-research","Thesis-driven equity analysis from public SEC EDGAR and market data; \u002Fanalyze, \u002Fscore, \u002Fcompare workflows with bundled Python tools (Claude Code, Cursor, Codex).","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fxvary-stock-research\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fxvary-stock-research\u002FSKILL.md",[],[],{"skillNo":97,"name":98,"nameZh":6,"description":99,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":100,"categories":101,"keywords":102,"publishedAt":19},"01M79AHCYJ9FV9RMHQ24HDRN33","xss-vulnerability-scanner","Scan xss vulnerability scanner operations. Auto-activating skill for Security Fundamentals.\nTriggers on: xss vulnerability scanner, xss vulnerability scanner\nPart of the Security Fundamentals skill category. Use when working with xss vulnerability scanner functionality. Trigger with phrases like \"xss vulnerability scanner\", \"xss scanner\", \"xss\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fxss-vulnerability-scanner\u002FSKILL.md",[],[]]