1. Deals
MGPanel API
  • Introducción — Getting Started
  • MCP Server — Model Context Protocol
  • Platform
    • Goals
      • 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
    • Web Editor
      • 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
        • Listar categorías de blog
        • Obtener artículo
        • Actualizar artículo
  • CRM
    • Invoices
      • Listar facturas
      • Estado de factura
      • Crear factura
      • Detalle de factura
    • Budgets
      • Listar presupuestos
      • Crear presupuesto
      • Detalle de presupuesto
      • Estado de presupuesto
      • Enviar presupuesto por email
    • Clients
      • Buscar clientes
      • Crear o actualizar cliente
    • Products
      • Listar productos
      • Crear o actualizar producto
    • Clients
      • Alta/actualización masiva de clientes
      • Listar etiquetas CRM
    • Deals
      • Listar oportunidades
        GET
      • Crear oportunidad
        POST
      • Detalle de oportunidad
        GET
      • Actualizar oportunidad
        PATCH
      • Agregar nota/actividad
        POST
    • 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
      • Crear formulario
      • Definición de un formulario
      • Editar formulario
      • Listar respuestas
      • Detalle de una respuesta
      • Actualizar estado de una respuesta
  1. Deals

Crear oportunidad

POST
/api/deals
Requiere name y client_id (o client.email). Si no se indica etapa usa el pipeline por defecto.

Solicitud

Parámetros de Header

Parámetros del Body application/jsonRequerido

Ejemplos

Respuestas

🟢200
application/json
OK
Bodyapplication/json

🟠400
Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location 'https://app.mgpanel.co/api/deals' \
--header 'X-Account-Nick: {{ACCOUNT_NICK}}' \
--header 'Authorization: Bearer {{API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
    "name": "Proyecto web",
    "client_id": "507f1f77bcf86cd799439011",
    "expected_value": 1500,
    "currency": "USD"
}'
Respuesta Ejemplo de Respuesta
{
    "success": true,
    "message": "Oportunidad creada exitosamente",
    "deal_id": "507f1f77bcf86cd799439011",
    "client_id": "507f1f77bcf86cd799439011",
    "stage_name": "Nuevo",
    "status": 1
}
Modificado en 2026-06-03 21:50:13
Anterior
Listar oportunidades
Siguiente
Detalle de oportunidad
Built with