1. Forms
MGPanel API
  • Introducción — Getting Started
  • MCP Server — Model Context Protocol
  • Platform
    • Goals
      • Configuration
        • Catálogo de estados
        • Campos personalizados de logros
      • Categories
        • Listar categorías
        • Crear categoría
        • Actualizar categoría
        • Eliminar categoría
      • Objectives
        • Listar objetivos
        • Listar objetivos (organización)
        • Detalle de objetivo
        • Crear objetivo
        • Actualizar objetivo
        • Eliminar objetivo
      • Achievements
        • Crear logro
        • Actualizar logro
        • Eliminar logro
    • Source
      • Fuente
        • Obtener resumen de Fuente
        • Actualizar resumen de Fuente
    • Account
      • Datos de la cuenta activa
      • Usuarios con acceso a la cuenta
  • Website
    • Functions
      • Listar funciones
      • Crear o actualizar función
      • Detalle de función
      • Eliminar función
      • Ejecutar función
      • Logs de función
      • Invocación pública (GET)
      • Invocación pública (POST)
    • Real Estate
      • Listar propiedades
      • Crear o actualizar propiedad
      • Detalle editorial de propiedad
      • Editar propiedad
      • Auto-traducir propiedad
    • Web Editor
      • Ver estado de localización del sitio
      • Activar o desactivar idiomas secundarios
      • Listar páginas
      • Detalle de página
      • Crear página
      • Actualizar metadatos de página
      • Actualizar contenido de sección
      • Obtener configuración global del sitio
      • Actualizar configuración global del sitio
      • Crear sección en página
    • Blog
      • Articles
        • Listar artículos
        • Crear artículo
        • Editar artículo por bloque
        • Listar categorías de blog
        • Obtener artículo
        • Actualizar artículo
  • CRM
    • Invoices
      • Listar facturas
      • Estado de factura
      • Detalle de factura
      • Crear factura
      • Enviar factura por email
      • Editar factura
    • Budgets
      • Listar presupuestos
      • Crear presupuesto
      • Detalle de presupuesto
      • Estado de presupuesto
      • Enviar presupuesto por email
      • Editar presupuesto
    • Clients
      • Buscar clientes
      • Crear o actualizar cliente
    • Products
      • Listar productos
      • Detalle editorial completo de producto
      • Editar núcleo editorial de producto
      • Auto-traducir producto
      • Crear o actualizar producto
    • Clients
      • Alta/actualización masiva de clientes
      • Listar etiquetas CRM
    • Deals
      • Listar oportunidades
      • Crear oportunidad
      • Detalle de oportunidad
      • Actualizar oportunidad
      • Agregar nota/actividad
    • Campaigns
      • Listar campañas
      • Crear campaña (borrador)
      • Detalle de campaña
      • Actualizar campaña (borrador)
      • Estado y métricas de campaña
      • Enviar o programar campaña
    • Lists
      • Listar listas
      • Crear lista
      • Detalle de lista
      • Agregar clientes a la lista
    • Forms
      • Listar formularios
        GET
      • Crear formulario
        POST
      • Definición de un formulario
        GET
      • Editar formulario
        PUT
      • Listar respuestas
        GET
      • Detalle de una respuesta
        GET
      • Auto-traducir formulario
        POST
      • Actualizar estado de una respuesta
        PUT
  • Raíz
  1. Forms

Definición de un formulario

GET
/api/forms/{id}
Devuelve la definición completa: campos (field_id, label, sublabel, placeholder, type, required, order, options, grid_size, status), resumen de notificaciones, página de gracias, traducciones (langs + translation_status) y submissions_count. No incluye las respuestas.

Solicitud

Parámetros de ruta

Parámetros de Header

Respuestas

🟢200
application/json
OK
Bodyapplication/json

🟠404
Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location 'https://app.mgpanel.co/api/forms/' \
--header 'X-Account-Nick: {{ACCOUNT_NICK}}' \
--header 'Authorization: Bearer {{API_KEY}}' \
--header 'Content-Type: application/json'
Respuesta Ejemplo de Respuesta
{
    "success": true,
    "form": {
        "_id": "507f1f77bcf86cd799439011",
        "code": "0001",
        "title": "Contacto",
        "type": 1,
        "status": 1,
        "fields": [
            {
                "field_id": "60a1000000000000000000aa",
                "label": "Email",
                "sublabel": null,
                "placeholder": "correo@ejemplo.com",
                "type": 11,
                "required": true,
                "order": 0,
                "options": [],
                "grid_size": 6,
                "status": true
            },
            {
                "field_id": "60a1000000000000000000ab",
                "label": "Motivo de contacto",
                "sublabel": null,
                "placeholder": null,
                "type": 40,
                "required": true,
                "order": 1,
                "options": [
                    {
                        "value": "ventas",
                        "text": "Ventas"
                    },
                    {
                        "value": "soporte",
                        "text": "Soporte"
                    }
                ],
                "grid_size": 12,
                "status": true
            }
        ],
        "notifications": {
            "primary": "admin@test.com",
            "auto_reply_enabled": false,
            "per_option_count": 0
        },
        "thanks": {
            "type": 1,
            "url": null,
            "message": null
        },
        "submissions_count": 12,
        "langs": [
            {
                "code": "us",
                "title": "Contact",
                "fields": [
                    {
                        "field_id": "60a1000000000000000000ab",
                        "label": "Reason for contact",
                        "sublabel": "",
                        "placeholder": "",
                        "options": [
                            {
                                "value": "ventas",
                                "text": "Sales"
                            },
                            {
                                "value": "soporte",
                                "text": "Support"
                            }
                        ]
                    }
                ],
                "thanks": {
                    "message": ""
                },
                "status": 1,
                "is_auto_translated": true,
                "stale": false
            }
        ],
        "translation_status": [
            {
                "code": "us",
                "name": "English",
                "translated": 6,
                "total": 11,
                "isAutoTranslated": true,
                "stale": false,
                "exists": true
            }
        ],
        "primary_lang": "es",
        "secondary_langs": [
            {
                "code": "us",
                "name": "English"
            }
        ],
        "date": "2026-04-01T12:00:00.000Z",
        "modified": null
    }
}
Modificado en 2026-09-02 22:39:03
Anterior
Crear formulario
Siguiente
Editar formulario
Built with