Hoy los leads vienen exclusivamente de formularios Meta Lead Ads de una Página conectada — se leen, no se crean por API.
POST /leads). Si quieres capturar un contacto a partir de un mensaje de WhatsApp o un comentario, guárdalo en tu propio CRM al recibir el webhook — ver Webhooks./accounts/:id/lead-forms/accounts/:id/leads?formId=…/accounts/:id/lead-forms{ name, locale?, questions[], privacy_policy:{url,link_text}, context_card?, thank_you_page?, follow_up_action_url? }. Meta no permite editarlo después de creado./accounts/:id/lead-forms/:formIdquestions)./accounts/:id/lead-forms/:formId/test-webhooklead.received de muestra (field_data derivado de las preguntas reales del form) a tus webhooks. Determinístico y no toca Meta — sirve para probar tu receptor sin esperar un lead real. Devuelve { ok, webhooksNotified }.Para crear/borrar test leads reales en Meta (que aparecen en el Ads Manager), usa el Lead Ads Testing Tool ↗ de Meta — su API no dispara webhook ni permite borrarlos.
Cuando alguien envía un Lead Ads de Meta, el sistema lo recoge solo y dispara lead.received por webhook — no necesitas hacer polling de /leads si ya tienes un webhook suscrito a ese evento.
curl "https://zoosial.com/accounts/acc_456/leads?formId=form_789" \ -H "Authorization: Bearer $SC_API_KEY"