Talleres

Crear un taller

Crea un taller en borrador. Las fechas y la zona horaria son obligatorias desde el inicio; los módulos con sesiones, lo que aprenderás, para quién es y las preguntas frecuentes se exigen al publicar.

POST

/workshops

Crear un taller

curl --request POST \
  --url https://hub.grou.com/api/ext/workshops \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "commercial": {
    "base_currency": "USD",
    "pricing": [
      {
        "currency": "USD",
        "value": 299
      }
    ]
  },
  "content": {
    "end_date": "2026-03-31T00:00:00Z",
    "faqs": [
      {
        "answer": "Sí.",
        "question": "¿Quedan grabadas las sesiones?"
      }
    ],
    "modules": [
      {
        "name": "Semana 1",
        "sessions": [
          {
            "date": "2026-03-01",
            "description": "Kickoff",
            "link": "https://meet.example.com/s1",
            "time": "18:00",
            "title": "Sesión en vivo 1"
          }
        ]
      }
    ],
    "slots": 30,
    "start_date": "2026-03-01T00:00:00Z",
    "target_audience": [
      "Emprendedores que venden online"
    ],
    "timezone": "America/Bogota",
    "what_you_will_learn": [
      "Cerrar ventas por WhatsApp"
    ]
  },
  "external_ref": "mi-plataforma-bootcamp-3",
  "general": {
    "name": "Bootcamp de Ventas — Cohorte 1"
  }
}
'

{
  "checkout_url": "<string>",
  "content": {
    "modules": [
      {
        "description": "<string>",
        "id": "<string>",
        "lessons": [
          {
            "id": "<string>",
            "name": "<string>",
            "provider": "<string>",
            "video_url": "<string>"
          }
        ],
        "name": "<string>",
        "sessions": [
          {
            "date": "<string>",
            "id": "<string>",
            "title": "<string>"
          }
        ]
      }
    ]
  },
  "created_at": "2023-11-07T05:31:56Z",
  "external_ref": "<string>",
  "id": "<string>",
  "state": "draft",
  "type": "program",
  "updated_at": "2023-11-07T05:31:56Z",
  "version_id": "<string>"
}

curl -X POST https://hub.grou.com/api/ext/workshops \
  -H "Authorization: Bearer $GROU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "general": { "name": "Bootcamp de Ventas — Cohorte 1" },
    "content": {
      "start_date": "2026-03-01T00:00:00Z",
      "end_date": "2026-03-31T00:00:00Z",
      "timezone": "America/Bogota",
      "what_you_will_learn": ["Cerrar ventas por WhatsApp"],
      "target_audience": ["Emprendedores que venden online"],
      "faqs": [{ "question": "¿Quedan grabadas las sesiones?", "answer": "Sí." }],
      "modules": [
        {
          "name": "Semana 1",
          "sessions": [
            { "title": "Sesión en vivo 1", "date": "2026-03-01", "time": "18:00", "link": "https://meet.example.com/s1" }
          ]
        }
      ]
    },
    "commercial": { "base_currency": "USD", "pricing": [{ "currency": "USD", "value": 299 }] }
  }'

Autorizaciones

Authorizationstringheaderobligatorio

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

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

contentobjectobligatorio

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

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

Respuesta

Borrador creado, con el id de cada módulo y sesió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

Autorizaciones

Cuerpo

Respuesta