Programas

Crear un programa

Crea un programa en borrador. Puedes crearlo sin contenido, pero para publicarlo necesita al menos un módulo con lecciones, un program_type y una miniatura. El body no acepta URLs de imagen: la miniatura se sube después con POST /programs/{id}/images.

POST

/programs

Crear un programa

curl --request POST \
  --url https://hub.grou.com/api/ext/programs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "commercial": {
    "base_currency": "USD",
    "pricing": [
      {
        "currency": "USD",
        "value": 99
      }
    ]
  },
  "content": {
    "modules": [
      {
        "description": "Introducción",
        "lessons": [
          {
            "name": "Bienvenida",
            "provider": "vimeo",
            "video_url": "https://vimeo.com/123"
          }
        ],
        "name": "Módulo 1 — Fundamentos"
      }
    ]
  },
  "external_ref": "mi-plataforma-diplomado-42",
  "general": {
    "category_ids": [
      "6a27c1f0a1b2c3d4e5f6535a"
    ],
    "description": "Programa completo de marketing.",
    "learning_outcomes": [
      "Armar un plan de contenidos"
    ],
    "name": "Diplomado en Marketing Digital"
  },
  "program_type": "diploma"
}
'

{
  "checkout_url": null,
  "content": {
    "modules": [
      {
        "description": "Introducción",
        "id": "6ab8c1f0a1b2c3d4e5f6b001",
        "lessons": [
          {
            "id": "6ab8c1f0a1b2c3d4e5f6c001",
            "name": "Bienvenida",
            "provider": "vimeo",
            "video_url": "https://vimeo.com/123"
          }
        ],
        "name": "Módulo 1 — Fundamentos"
      }
    ]
  },
  "created_at": "2026-01-01T00:00:00.000Z",
  "external_ref": "mi-plataforma-diplomado-42",
  "id": "6ab8c1f0a1b2c3d4e5f6f001",
  "state": "draft",
  "type": "program",
  "updated_at": "2026-01-01T00:00:00.000Z",
  "version_id": "6ab8c1f0a1b2c3d4e5f6a001"
}

Crea el borrador; luego sube la miniatura y publica. Guarda el id de la respuesta (o usa tu external_ref para encontrarlo después).

curl -X POST https://hub.grou.com/api/ext/programs \
  -H "Authorization: Bearer $GROU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "external_ref": "mi-plataforma-diplomado-42",
    "program_type": "diploma",
    "general": { "name": "Diplomado en Marketing Digital" },
    "content": {
      "modules": [
        {
          "name": "Módulo 1 — Fundamentos",
          "lessons": [
            { "name": "Bienvenida", "provider": "vimeo", "video_url": "https://vimeo.com/123" }
          ]
        }
      ]
    },
    "commercial": {
      "base_currency": "USD",
      "pricing": [{ "currency": "USD", "value": 99 }]
    }
  }'

Autorizaciones

Authorizationstringheaderobligatorio

Tu API Key del Hub (Configuración → API Keys), que empieza por sk_. Solo se muestra una vez al generarla.

Cuerpo

commercialobject

Configuración comercial. Un producto vende o un pago único (precio y cuotas opcionales) o planes de suscripción, no ambos. La tasa de interés de las cuotas se configura en el Hub y se conserva al editar.

Mostrar child attributes

contentobject

Mostrar child attributes

coproductionobject[]

Reparto de la coproducción. Incluye tu propio owner_user_id (de GET /me); los porcentajes deben sumar 100.

Mostrar child attributes

external_refstring

Tu identificador para este producto.

Minimum string length: 1

generalobjectobligatorio

Datos generales. No acepta URLs de imagen: la miniatura se sube aparte. Un campo desconocido devuelve 400.

Mostrar child attributes

program_typeenum<string>

Diplomado o curso. Requerido para publicar.

Opciones disponibles: diploma, course

Respuesta

Borrador creado, con el id de cada módulo y lección.

checkout_urlstring | nullobligatorio

Link de pago. Solo cuando el recurso está published.

contentobject

El contenido con el id de cada elemento, para enviarlo de vuelta al editar.

Mostrar child attributes

created_atstringobligatorio

external_refstring | null

Tu identificador, si lo enviaste al crear.

idstringobligatorio

stateenum<string>obligatorio

draft: borrador, no visible para compradores. published: a la venta, con checkout_url. unpublished: retirado de la venta, se puede volver a publicar.

Opciones disponibles: draft, published, unpublished

typeenum<string>obligatorio

Opciones disponibles: program, external, workshop, checkout

updated_atstringobligatorio

version_idstring | null

Versión actual. Siempre null en checkouts.

¿Aún necesitas ayuda? Comparte una idea