Ir al contenido principal
API para mentores

Introducción a la API para mentores

Crea, edita, publica y despublica tus programas, talleres y checkouts desde tu propia plataforma o desde un agente de IA.

La API para mentores es una API REST que te permite gestionar tus productos de Grou desde fuera del Hub: tu propia plataforma, una automatización o un agente de IA (a través de nuestro MCP).

Con ella puedes recorrer el ciclo completo de un producto: crear un borrador → editarlo → subir la imagen → publicarlo (obteniendo el link de pago) y, cuando quieras, despublicarlo. Todo lo que hagas por la API aparece en tu Hub exactamente igual que si lo hubieras hecho a mano.

URL base

https://hub.grou.com/api/ext

Todas las rutas de esta documentación son relativas a esta URL. Cada request se autentica con tu API Key (ver Autenticación).

Qué puedes gestionar

RecursoRutaQué es
Programas/programsDiplomados y cursos con módulos y lecciones en video
Programas externos/externalProductos cuyo contenido vive en otra plataforma (solo un link)
Talleres/workshopsCohortes con fechas y sesiones en vivo
Checkouts/checkoutsPáginas de pago que venden uno o varios productos, con bumps, descuentos y diseño

Además hay rutas de apoyo:

  • GET /me — confirma a qué cuenta pertenece tu API Key.
  • GET /reference/{kind} — valores válidos (categorías, monedas, proveedores de video…). Ver Datos de referencia.
  • GET /{tipo} — lista tus productos. Ver Mi catálogo.

Estados de un producto

Todos los recursos usan los mismos tres estados públicos:

EstadoSignificado
draftBorrador. Editable, no visible para compradores. checkout_url es null.
publishedPublicado y a la venta. checkout_url tiene el link de pago.
unpublishedRetirado de la venta (no se borra). Se puede volver a publicar.

Flujo típico

  1. POST /programs (o /workshops, /external) → crea el borrador.
  2. POST /programs/{id}/images → sube la miniatura.
  3. POST /programs/{id}/publish → publica y recibe el checkout_url.
  4. Opcional: POST /checkouts para armar una página de venta con varios productos.

El objeto Resource

Casi todas las respuestas devuelven un Resource con la misma forma:

{
  "id": "6ab8...f001",
  "type": "program",
  "external_ref": "mi-plataforma-diplomado-42",
  "state": "published",
  "version_id": "6ab8...v001",
  "checkout_url": "https://<dominio-de-checkout>/v2/6ab8...f990",
  "created_at": "2026-01-01T00:00:00Z",
  "updated_at": "2026-01-01T00:00:00Z"
}

  • external_ref es un identificador tuyo (opcional) que puedes mandar al crear. Te sirve para encontrar el producto después sin haber guardado nuestro id.
  • En programas y talleres, GET, crear y editar también devuelven el árbol content con el id de cada módulo, lección o sesión.

Contenido de esta guía

  • Autenticación (API Key)
  • Programas · Programas externos · Talleres · Checkouts
  • Imágenes
  • Configuración comercial
  • Ciclo de vida y versiones
  • Mi catálogo (listar y buscar)
  • Datos de referencia
  • Errores

¿Aún necesitas ayuda? Comparte una idea