# MGPanel API

## Docs
- [Introducción — Getting Started](https://mgpanel.apidog.io/introducci%C3%B3n-getting-started-2188065m0.md): 
- [MCP Server — Model Context Protocol](https://mgpanel.apidog.io/mcp-server-model-context-protocol-2188066m0.md): 

## API Docs
- Platform > Goals > Categories [Listar categorías](https://mgpanel.apidog.io/listar-categor%C3%ADas-34401817e0.md): Lista categorías de objetivos de la cuenta autenticada.
- Platform > Goals > Categories [Crear categoría](https://mgpanel.apidog.io/crear-categor%C3%ADa-34401818e0.md): Crea una nueva categoría de objetivos para la cuenta autenticada.
- Platform > Goals > Categories [Actualizar categoría](https://mgpanel.apidog.io/actualizar-categor%C3%ADa-34401819e0.md): Actualiza campos de una categoría (name, icon, description). Mínimo un campo.
- Platform > Goals > Categories [Eliminar categoría](https://mgpanel.apidog.io/eliminar-categor%C3%ADa-34401820e0.md): Elimina una categoría. Bloquea si tiene objetivos asociados.
- Platform > Goals > Objectives [Listar objetivos](https://mgpanel.apidog.io/listar-objetivos-34401821e0.md): Lista objetivos de la cuenta autenticada. Incluye paginación, filtro opcional por status y filtros opcionales sobre logros (achievements).
- Platform > Goals > Objectives [Listar objetivos (organización)](https://mgpanel.apidog.io/listar-objetivos-organizaci%C3%B3n-34401823e0.md): Cuando la cuenta autenticada es una organización, devuelve objetivos de todas las cuentas hijas. Incluye account_id y account_name por cada objetivo.
- Platform > Goals > Objectives [Detalle de objetivo](https://mgpanel.apidog.io/detalle-de-objetivo-34401824e0.md): Devuelve el objetivo completo con logros (achievements).
- Platform > Goals > Objectives [Crear objetivo](https://mgpanel.apidog.io/crear-objetivo-34401822e0.md): Crea un objetivo en la cuenta autenticada.
- Platform > Goals > Objectives [Actualizar objetivo](https://mgpanel.apidog.io/actualizar-objetivo-34401825e0.md): Actualiza campos del objetivo. Mínimo un campo.
- Platform > Goals > Objectives [Eliminar objetivo](https://mgpanel.apidog.io/eliminar-objetivo-34401826e0.md): Elimina un objetivo de la cuenta autenticada.
- Platform > Goals > Achievements [Crear logro](https://mgpanel.apidog.io/crear-logro-34401827e0.md): Crea un logro (achievement) dentro de un objetivo existente.
- Platform > Goals > Achievements [Actualizar logro](https://mgpanel.apidog.io/actualizar-logro-34401828e0.md): Actualiza campos de un logro. Mínimo un campo.
- Platform > Goals > Achievements [Eliminar logro](https://mgpanel.apidog.io/eliminar-logro-34401829e0.md): Elimina un logro de un objetivo.
- Platform > Source > Fuente [Obtener resumen de Fuente](https://mgpanel.apidog.io/obtener-resumen-de-fuente-34823144e0.md): Devuelve el resumen (Fuente) de la cuenta. Si no existe todavía, devuelve is_empty=true para que el cliente pueda solicitarlo al usuario.
- Platform > Source > Fuente [Actualizar resumen de Fuente](https://mgpanel.apidog.io/actualizar-resumen-de-fuente-34823145e0.md): Crea o reemplaza el resumen (Fuente) de la cuenta. Se guarda en draft/estado interno del módulo Source y puede ser editado luego desde el panel.
- Platform > Account [Datos de la cuenta activa](https://mgpanel.apidog.io/datos-de-la-cuenta-activa-34920640e0.md): Autenticación por API Key. Contexto de cuenta vía X-Account-Nick.
- Platform > Account [Usuarios con acceso a la cuenta](https://mgpanel.apidog.io/usuarios-con-acceso-a-la-cuenta-34920641e0.md): 
- Website > Web Editor [Listar páginas](https://mgpanel.apidog.io/listar-p%C3%A1ginas-34313537e0.md): Devuelve todas las páginas del draft del sitio. Sin contenido HTML.
- Website > Web Editor [Detalle de página](https://mgpanel.apidog.io/detalle-de-p%C3%A1gina-34314325e0.md): Devuelve la página completa con todas sus secciones (HTML, CSS, JS).
- Website > Web Editor [Crear página](https://mgpanel.apidog.io/crear-p%C3%A1gina-34314324e0.md): Crea una página nueva en el draft. Devuelve section_code de la sección inicial para editar de inmediato.
- Website > Web Editor [Actualizar metadatos de página](https://mgpanel.apidog.io/actualizar-metadatos-de-p%C3%A1gina-34314326e0.md): Actualiza title, name, description, directory y/o url. Mínimo un campo. Las páginas protegidas no permiten cambiar url.
- Website > Web Editor [Actualizar contenido de sección](https://mgpanel.apidog.io/actualizar-contenido-de-secci%C3%B3n-34314327e0.md): Reescribe HTML, CSS y/o JavaScript de una sección. Mínimo un campo. Obtén section_code con GET /pages/{slug}. Si envías `lang` distinto del idioma principal de la cuenta junto con `javascript`, el JS se guarda en la entrada de traducción `lang[]` de la sección (igual que en el panel).
- Website > Web Editor [Obtener configuración global del sitio](https://mgpanel.apidog.io/obtener-configuraci%C3%B3n-global-del-sitio-34823146e0.md): Devuelve la configuración global del draft del sitio: head, body_start, body_end, favicon, CSS general y JavaScript general.
- Website > Web Editor [Actualizar configuración global del sitio](https://mgpanel.apidog.io/actualizar-configuraci%C3%B3n-global-del-sitio-34823147e0.md): Actualiza parcialmente la configuración global del draft: head, body_start, body_end, favicon, CSS general y/o JavaScript general. Mínimo un campo.
- Website > Web Editor [Crear sección en página](https://mgpanel.apidog.io/crear-secci%C3%B3n-en-p%C3%A1gina-34823148e0.md): Crea una nueva sección vacía dentro de una página del draft. Devuelve section_code para editar el contenido inmediatamente.
- Website > Blog > Articles [Listar artículos](https://mgpanel.apidog.io/listar-art%C3%ADculos-36850550e0.md): Devuelve artículos paginados. Por defecto filtra type=blog. Usa status=0 para borradores, status=1 para publicados.
- Website > Blog > Articles [Crear artículo](https://mgpanel.apidog.io/crear-art%C3%ADculo-36850551e0.md): Crea un artículo de blog. El slug (url) se auto-genera desde el title si se omite. El content acepta texto plano, HTML o Editor.js JSON string.
- Website > Blog > Articles [Listar categorías de blog](https://mgpanel.apidog.io/listar-categor%C3%ADas-de-blog-36850552e0.md): Devuelve las categorías de blog activas (type=blog, status=1) de la cuenta.
- Website > Blog > Articles [Obtener artículo](https://mgpanel.apidog.io/obtener-art%C3%ADculo-36850553e0.md): Devuelve el detalle completo de un artículo, incluyendo content, cover_image_url y public_url.
- Website > Blog > Articles [Actualizar artículo](https://mgpanel.apidog.io/actualizar-art%C3%ADculo-36850554e0.md): Actualiza parcialmente un artículo. Solo se modifican los campos provistos. Para publicar un borrador pasar status=1.
- CRM > Invoices [Listar facturas](https://mgpanel.apidog.io/listar-facturas-34920634e0.md): Lista facturas con paginación. Query clientId, dateFrom y dateTo como en el backend.
- CRM > Invoices [Estado de factura](https://mgpanel.apidog.io/estado-de-factura-33749847e0.md): 
- CRM > Invoices [Crear factura](https://mgpanel.apidog.io/crear-factura-33091060e0.md): 
- CRM > Invoices [Detalle de factura](https://mgpanel.apidog.io/detalle-de-factura-34920635e0.md): Incluye items, cliente, montos de pago y url pública del sitio del cliente.
- CRM > Budgets [Listar presupuestos](https://mgpanel.apidog.io/listar-presupuestos-34823149e0.md): Lista presupuestos (cotizaciones) con paginación y filtros opcionales.
- CRM > Budgets [Crear presupuesto](https://mgpanel.apidog.io/crear-presupuesto-34823150e0.md): Crea un presupuesto en borrador (status 1). Acepta client_id o client con email (upsert). Ítems con description y/o product_id.
- CRM > Budgets [Detalle de presupuesto](https://mgpanel.apidog.io/detalle-de-presupuesto-34823151e0.md): Obtiene un presupuesto por ID con datos básicos del cliente.
- CRM > Budgets [Estado de presupuesto](https://mgpanel.apidog.io/estado-de-presupuesto-34823152e0.md): Consulta el estado numérico y etiqueta del presupuesto.
- CRM > Budgets [Enviar presupuesto por email](https://mgpanel.apidog.io/enviar-presupuesto-por-email-34823153e0.md): Marca el presupuesto como enviado (status 10) y envía el correo al cliente con enlace público.
- CRM > Clients [Buscar clientes](https://mgpanel.apidog.io/buscar-clientes-34920636e0.md): Requiere query search (texto en nombre, email o teléfono).
- CRM > Clients [Crear o actualizar cliente](https://mgpanel.apidog.io/crear-o-actualizar-cliente-34920637e0.md): Upsert por email único. Campos: name, email (requerido), phone, address, city.
- CRM > Products [Listar productos](https://mgpanel.apidog.io/listar-productos-34920638e0.md): Productos activos con onlineStore distinto de false. API Key requerida.
- CRM > Products [Crear o actualizar producto](https://mgpanel.apidog.io/crear-o-actualizar-producto-34920639e0.md): Upsert por SKU si se envía sku.
- CRM > Clients [Alta/actualización masiva de clientes](https://mgpanel.apidog.io/altaactualizaci%C3%B3n-masiva-de-clientes-37182696e0.md): Upsert por email (máx 200). Deduplica, asigna status y etiquetas (por nombre o id). Devuelve resumen (created/updated/skipped/failed) y errores indexados.
- CRM > Clients [Listar etiquetas CRM](https://mgpanel.apidog.io/listar-etiquetas-crm-37182697e0.md): Catálogo de etiquetas CRM de la cuenta (id, name, group, color) para segmentación.
- CRM > Deals [Listar oportunidades](https://mgpanel.apidog.io/listar-oportunidades-37182698e0.md): Paginación y filtros: status, pipelineId, stageId, clientId.
- CRM > Deals [Crear oportunidad](https://mgpanel.apidog.io/crear-oportunidad-37182699e0.md): Requiere name y client_id (o client.email). Si no se indica etapa usa el pipeline por defecto.
- CRM > Deals [Detalle de oportunidad](https://mgpanel.apidog.io/detalle-de-oportunidad-37182700e0.md): Detalle completo (items, valor, notas, historial).
- CRM > Deals [Actualizar oportunidad](https://mgpanel.apidog.io/actualizar-oportunidad-37182701e0.md): Actualiza campos o mueve de etapa (stage_id). Si la etapa es Perdida y la cuenta lo exige, lost_reason es obligatorio.
- CRM > Deals [Agregar nota/actividad](https://mgpanel.apidog.io/agregar-notaactividad-37182702e0.md): Tipos: note, call, meeting, email, task, seguimiento. due_date para tareas/seguimientos.
- CRM > Campaigns [Listar campañas](https://mgpanel.apidog.io/listar-campa%C3%B1as-37182703e0.md): Paginación y filtro status (0 cancelada, 1 borrador, 10 programada, 70 enviada).
- CRM > Campaigns [Crear campaña (borrador)](https://mgpanel.apidog.io/crear-campa%C3%B1a-borrador-37182704e0.md): Crea borrador (status 1). content acepta HTML o texto plano. Asocia listas con list_ids.
- CRM > Campaigns [Detalle de campaña](https://mgpanel.apidog.io/detalle-de-campa%C3%B1a-37182705e0.md): Detalle completo con métricas.
- CRM > Campaigns [Actualizar campaña (borrador)](https://mgpanel.apidog.io/actualizar-campa%C3%B1a-borrador-37182706e0.md): Falla con CAMPAIGN_ALREADY_SENT si ya fue enviada.
- CRM > Campaigns [Estado y métricas de campaña](https://mgpanel.apidog.io/estado-y-m%C3%A9tricas-de-campa%C3%B1a-37182707e0.md): Estado + métricas resumidas (sent, delivered, opened, clicks, failed).
- CRM > Campaigns [Enviar o programar campaña](https://mgpanel.apidog.io/enviar-o-programar-campa%C3%B1a-37182708e0.md): mode=now encola de inmediato; mode=scheduled requiere scheduled_at futuro. Requiere listas.
- CRM > Lists [Listar listas](https://mgpanel.apidog.io/listar-listas-37182709e0.md): Listas de destinatarios con conteo de clientes.
- CRM > Lists [Crear lista](https://mgpanel.apidog.io/crear-lista-37182710e0.md): Crea una lista vacía. Requiere title.
- CRM > Lists [Detalle de lista](https://mgpanel.apidog.io/detalle-de-lista-37182711e0.md): Conteo de clientes/extra. preview (1-50) para muestra de clientes.
- CRM > Lists [Agregar clientes a la lista](https://mgpanel.apidog.io/agregar-clientes-a-la-lista-37182712e0.md): Agrega por client_ids o por segmento (status y/o tags por nombre/id). Deduplica con $addToSet. Devuelve added/already_present/total.
- CRM > Forms [Listar formularios](https://mgpanel.apidog.io/listar-formularios-37182713e0.md): Lista formularios con paginación y filtros (status, type, search). Devuelve resumen con fields_count y submissions_count.
- CRM > Forms [Crear formulario](https://mgpanel.apidog.io/crear-formulario-37182714e0.md): Crea un formulario. Requiere title y fields[] con al menos un campo email (type 11). El code (FOR-XXXX) se genera en el servidor. status 0=borrador (default), 1=activo.
- CRM > Forms [Definición de un formulario](https://mgpanel.apidog.io/definici%C3%B3n-de-un-formulario-37182715e0.md): Devuelve la definición (campos con field_id, type, required, options; resumen de notificaciones; página de gracias). No incluye las respuestas.
- CRM > Forms [Editar formulario](https://mgpanel.apidog.io/editar-formulario-37182716e0.md): Edita la definición (parcial): title, type, status, fields, notifications, thanks. Conserva code y respuestas. Si envías fields[], debe incluir un campo email (type 11).
- CRM > Forms [Listar respuestas](https://mgpanel.apidog.io/listar-respuestas-37182717e0.md): Lista las respuestas (submissions) de un formulario con paginación y filtro por status. Resumen por respuesta (sin valores completos).
- CRM > Forms [Detalle de una respuesta](https://mgpanel.apidog.io/detalle-de-una-respuesta-37182718e0.md): Devuelve el detalle completo de una respuesta: valores (field_id, label, value), cliente y metadata.
- CRM > Forms [Actualizar estado de una respuesta](https://mgpanel.apidog.io/actualizar-estado-de-una-respuesta-37182719e0.md): Cambia el estado de una respuesta. status: 1=Nuevo, 2=Contactado, 3=A Oportunidad, 4=Descartado. Con status=3 se crea automáticamente una oportunidad (deal) y se devuelve deal_id.