Programas externos

Vende productos cuyo contenido vive en otra plataforma; solo necesitas un link.

Written By Jacobo

Last updated 23 days ago

Un programa externo es un producto cuyo contenido está alojado fuera de Grou (tu propia plataforma, una comunidad, etc.). No tiene módulos ni lecciones: solo un external_url al que accede el comprador.

Como no requiere currículo, se puede publicar inmediatamente después de crearlo (una vez tenga miniatura y precio).

Al editar (PATCH) se envía el body completo, igual que al crear: general.name y content.external_url siempre son obligatorios.

Método	Ruta	Qué hace
`POST`	`/external`	Crea un borrador
`GET`	`/external`	Lista tus programas externos
`GET`	`/external/{id}`	Devuelve el producto y su estado
`PATCH`	`/external/{id}`	Edita el borrador (o abre uno nuevo si ya está publicado)
`POST`	`/external/{id}/images`	Sube la miniatura
`POST`	`/external/{id}/publish`	Publica y genera el `checkout_url`
`POST`	`/external/{id}/unpublish`	Lo retira de la venta
`GET`	`/external/{id}/versions`	Historial de versiones

Body

Campo	Requerido	Descripción
`external_ref`	No	Tu identificador para este producto
`general.name`	Sí	Nombre (máx. 120 caracteres)
`general.description`	No	Descripción
`general.category_ids`	No	Ids de categorías (`principal` / `subcategoria`)
`content.external_url`	Sí	URL donde vive el contenido
`commercial`	No	Precios, cuotas o suscripciones
`coproduction`	No	Lista de `{ mentor_id, percentage }`

Ejemplo — crear un borrador

POST /api/ext/external
Authorization: Bearer sk_<tu-api-key>
Content-Type: application/json

{
  "external_ref": "mi-plataforma-ext-7",
  "general": {
    "name": "Masterclass externa",
    "description": "Acceso a contenido alojado externamente."
  },
  "content": {
    "external_url": "https://mi-plataforma.com/curso/7"
  },
  "commercial": {
    "base_currency": "USD",
    "pricing": [{ "currency": "USD", "value": 49.0 }]
  }
}

Respuesta 201 Created:

{
  "id": "6ab8...e001",
  "type": "external",
  "external_ref": "mi-plataforma-ext-7",
  "state": "draft",
  "version_id": "6ab8...v001",
  "checkout_url": null,
  "created_at": "2026-01-01T00:00:00Z",
  "updated_at": "2026-01-01T00:00:00Z"
}

Was this helpful?

Still need help? Share an idea