Export Leads

Export lead submissions from a Meta instant form (lead form) for a date range: each lead's id, created_time and submitted field values. Returns BARE numeric lead ids — Meta's own CSV export prefixes ids with 'l:', which is a CSV artifact, not part of the id; strip it when cross-referencing CSV exports against this tool. Dates are YYYY-MM-DD, UTC, inclusive. Requires the connected Meta token to hold the leads_retrieval permission — if it is missing the error says exactly that; reconnect Meta to grant it. Large ranges are capped (2000 leads / 20 pages / 60s) and flagged truncated: true — narrow the date range and re-call for the remainder. Find form ids with zuckerbot_lead_forms.

{
  "tool": "zuckerbot_export_leads",
  "arguments": {
    "form_id": "<form_id>",
    "date_from": "<date_from>",
    "date_to": "<date_to>"
  }
}