Recaudo Docs

Marketing

Páginas de aterrizaje

Crea, edita y publica páginas de aterrizaje desde tu sistema o desde un agente. Es el mismo motor del editor visual: lo que haces por API se ve igual en el editor y al revés.

GET /v1/landing-pages Lista las páginas (filtra con status=draft, published o unpublished).
GET /v1/landing-pages/templates Plantillas disponibles para crear una página.
GET /v1/landing-pages/{id} Una página con su documento completo (include_document=false para omitirlo).
POST /v1/landing-pages Crea una página desde plantilla, escrita por la IA o con tu propio documento.
PATCH /v1/landing-pages/{id} Cambia título, dirección, ajustes o el borrador completo.
POST /v1/landing-pages/{id}/publish Publica el borrador actual.
POST /v1/landing-pages/{id}/unpublish Quita la página de internet; el borrador se conserva.
GET /v1/landing-pages/{id}/analytics Visitas, contactos, clics a WhatsApp, pagos y fuentes (days=7, 30 o 90).
DELETE /v1/landing-pages/{id} Borra la página y la quita de internet.

Crear una página

Manda una de tres: template, ai_description o document. Sin ninguna, se crea una página en blanco con los colores y la letra de tu marca.

Campo Descripción
title Nombre interno de la página. También es el título de la pestaña si no defines uno en SEO.
slug Parte final de la dirección (promo-verano). Si ya existe, se agrega un número.
template Clave de una plantilla de /v1/landing-pages/templates.
ai_description Qué debe lograr la página. La IA elige las secciones y escribe los textos con los datos reales de tu negocio (productos, horarios, WhatsApp). Necesita una llave de IA conectada o la prueba gratuita.
document Documento JSON del editor (secciones, elementos, tema y SEO), como lo devuelve GET.
locale es, en o pt_BR. Por defecto, el idioma de tu cuenta.
publish true para publicarla al crearla.
Petición
curl -X POST "https://recaudo.app/api/v1/landing-pages" \
  -H "Authorization: Bearer sk_live_tu_secret_key" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Promo limpieza dental",
    "ai_description": "Limpieza dental a $499 en Monterrey, agenda por WhatsApp",
    "publish": true
  }'
Respuesta
{
  "object": "landing_page",
  "data": {
    "id": "8f1c2d3e-4a5b-4c6d-8e7f-9a0b1c2d3e4f",
    "object": "landing_page",
    "title": "Promo limpieza dental",
    "slug": "promo-limpieza-dental",
    "status": "published",
    "locale": "es",
    "template": "ai",
    "url": "https://tu-negocio.recaudo.app/p/promo-limpieza-dental",
    "is_home": true,
    "revision": 1,
    "has_unpublished_changes": false,
    "settings": {},
    "published_at": "2026-11-20T18:30:02+00:00",
    "document": { "version": 1, "locale": "es", "theme": { … }, "meta": { … }, "sections": [ … ] }
  }
}

Formulario con uno de tus formularios

El elemento form puede usar sus propios campos (source=page, el formulario rápido) o uno de tus formularios del módulo Formularios (source=lead_form). Con lead_form la página pinta los campos de ese formulario con el diseño de la página y guarda cada respuesta en él.

Campo Descripción
props.source page (por defecto) o lead_form.
props.lead_form_id UUID de un formulario publicado de tu cuenta. Si no es de tu cuenta, POST y PATCH responden 422 con code lead_form_not_found.
Petición
{
  "id": "e4k2m9q7xa",
  "type": "form",
  "props": {
    "source": "lead_form",
    "lead_form_id": "3b6f0c1e-9d2a-4e5b-8c7d-1a2b3c4d5e6f",
    "submit_label": "Quiero mi cotización",
    "success_message": "¡Gracias! Te escribimos hoy mismo."
  },
  "items": [],
  "layout": { … },
  "style": { … }
}
  • Corre lo mismo que un envío en la página del formulario: crea o actualiza al cliente, aplica sus listas y etiquetas, guarda la aceptación de términos, llama a su webhook y dispara "Formulario enviado" (form.submitted) con landing_page_id y UTM.
  • La página conserva su conteo de contactos, la atribución (UTM, fbclid, gclid) y manda un solo evento Lead a Meta con el mismo event_id que el píxel.
  • Los campos llegan como f[field_0], f[field_1]… en el orden del formulario; si pide términos, también f[accept_terms]=1.
  • Si despublicas el formulario, la página muestra un aviso y el envío responde 422 con un mensaje claro.
  • Documento: es JSON, nunca HTML. Cada elemento tiene type, props, style por dispositivo (desktop, tablet, mobile) y layout en columnas de la cuadrícula. Lo más fácil es leerlo con GET, cambiar lo que necesitas y mandarlo completo con PATCH.
  • Revisiones: cada PATCH con document sube revision. Si mandas revision y alguien guardó después (en el editor o por API), responde 409 y no pisa sus cambios.
  • Seguridad: el texto enriquecido pasa por una lista de etiquetas permitidas, las ligas solo aceptan http, https, mailto y tel, y los scripts se quitan. Los campos que no se reconocen se ignoran.
  • Límites del plan: publicar una página más de las que permite tu plan responde 403 con code limit_pages.
  • Errores de IA: ai_unavailable (no hay llave de IA conectada), ai_limit (se acabó la prueba gratuita) y ai_failed (la IA no respondió bien; intenta de nuevo).
  • Contactos: cada formulario enviado crea o actualiza al cliente, dispara el evento lead.created a tus webhooks y el disparador "Formulario de página de aterrizaje enviado" de tus automatizaciones, con UTM, fbclid y gclid.
  • MCP: las mismas acciones están como herramientas (create_landing_page, publish_landing_page, get_landing_page_analytics…).
¿Te sirvió esta página? Gracias por avisarnos.
Esc