Accesos de academias

GET/api/v1/access/mappings

Listar relaciones de cursos externos

Devuelve el diccionario que traduce los IDs estables de una academia a tus Products de Clonify.

Parámetros de consulta

providerstring

Filtra por plataforma o conector.

account_idstring

Filtra por la escuela concreta dentro de esa plataforma.

bash

curl "https://www.clonify.com/api/v1/access/mappings" \
  -H "Authorization: Bearer clk_live_…"

POST/api/v1/access/mappings

Relacionar un curso externo

Crea o cambia la relación entre un curso de la academia y un Product de tu cuenta. Es idempotente por plataforma, cuenta e ID externo.

Permiso de escritura

Cuerpo (JSON)

providerstringobligatorio

Identificador estable del conector, por ejemplo wordpress o custom_web.

account_idstringobligatorio

Identificador estable de la escuela o instalación.

external_product_idstringobligatorio

ID inmutable del curso en la academia; nunca uses el título.

external_product_namestring

Nombre visible, solo para diagnóstico.

product_idintegerobligatorio

ID del Product correspondiente en Clonify.

access_urlstring

URL opcional donde el alumno abre el curso. Debe ser http(s).

bash

curl -X POST "https://www.clonify.com/api/v1/access/mappings" \
  -H "Authorization: Bearer clk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"provider":"…","account_id":"…","external_product_id":"…","product_id":1}'

DELETE/api/v1/access/mappings

Quitar una relación de curso

Elimina el diccionario; no borra el historial de accesos ya recibido.

Permiso de borrado

Parámetros de consulta

providerstringobligatorio

Plataforma o conector de la relación.

account_idstringobligatorio

Escuela concreta de la relación.

external_product_idstringobligatorio

ID estable del curso externo.

bash

curl -X DELETE "https://www.clonify.com/api/v1/access/mappings" \
  -H "Authorization: Bearer clk_live_…" \
  -H "Content-Type: application/json" \
  -d '{}'

json

{ "deleted": true }

POST/api/v1/access/sync

Sincronizar los accesos de una persona

Puerta única para WordPress, academias y webs propias. Activa o caduca pases usando IDs estables, une la identidad por email y evita que el Clon vuelva a vender lo que la persona ya posee.

Permiso de escritura

Cuerpo (JSON)

providerstringobligatorio

Identificador estable del conector.

account_idstringobligatorio

Identificador estable de la escuela o instalación.

modestringobligatorio

snapshot = foto completa actual; patch = solo los cambios incluidos.Valores: snapshot · patch

observed_atISO 8601obligatorio

Cuándo la plataforma observó este estado. Un evento más antiguo no pisa uno reciente.

event_idstring

Referencia opcional del webhook o entrega para auditoría.

personobjectobligatorio

Objeto con external_user_id y email; name es opcional.

accessesobject[] (0..200)obligatorio

Lista de cursos: external_product_id, status active/revoked y, opcionalmente, product_id, nombre, URL, alta y caducidad.

notifyboolean

Por defecto true. Prepara la bienvenida de los productos recién obtenidos; respeta el correo desactivado del producto. false la silencia.

trigger_automationsboolean

Por defecto true. Inicia las secuencias activas por etiqueta de alumno al ganar acceso. Para importar sin correos, enviar false junto con notify=false.

bash

curl -X POST "https://www.clonify.com/api/v1/access/sync" \
  -H "Authorization: Bearer clk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"provider":"…","account_id":"…","mode":"snapshot","observed_at":"2026-07-01T00:00:00Z","person":[{"…":"…"}],"accesses":[{"…":"…"}]}'

json

{
  "object": "access_sync",
  "provider": "wordpress",
  "account_id": "academia-principal",
  "mode": "snapshot",
  "received": 2,
  "activated": 2,
  "revoked": 1,
  "stale_ignored": 0,
  "unmapped": [],
  "follow_up": {
    "job_id": 123,
    "product_ids": [42, 43],
    "welcome_requested": true,
    "automations_requested": true,
    "status": "queued"
  }
}

Accesos de academias

GET/api/v1/access/mappings

Listar relaciones de cursos externos

Devuelve el diccionario que traduce los IDs estables de una academia a tus Products de Clonify.

Parámetros de consulta

providerstring

Filtra por plataforma o conector.

account_idstring

Filtra por la escuela concreta dentro de esa plataforma.

bash

curl "https://www.clonify.com/api/v1/access/mappings" \
  -H "Authorization: Bearer clk_live_…"

POST/api/v1/access/mappings

Relacionar un curso externo

Crea o cambia la relación entre un curso de la academia y un Product de tu cuenta. Es idempotente por plataforma, cuenta e ID externo.

Permiso de escritura

Cuerpo (JSON)

providerstringobligatorio

Identificador estable del conector, por ejemplo wordpress o custom_web.

account_idstringobligatorio

Identificador estable de la escuela o instalación.

external_product_idstringobligatorio

ID inmutable del curso en la academia; nunca uses el título.

external_product_namestring

Nombre visible, solo para diagnóstico.

product_idintegerobligatorio

ID del Product correspondiente en Clonify.

access_urlstring

URL opcional donde el alumno abre el curso. Debe ser http(s).

bash

curl -X POST "https://www.clonify.com/api/v1/access/mappings" \
  -H "Authorization: Bearer clk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"provider":"…","account_id":"…","external_product_id":"…","product_id":1}'

DELETE/api/v1/access/mappings

Quitar una relación de curso

Elimina el diccionario; no borra el historial de accesos ya recibido.

Permiso de borrado

Parámetros de consulta

providerstringobligatorio

Plataforma o conector de la relación.

account_idstringobligatorio

Escuela concreta de la relación.

external_product_idstringobligatorio

ID estable del curso externo.

bash

curl -X DELETE "https://www.clonify.com/api/v1/access/mappings" \
  -H "Authorization: Bearer clk_live_…" \
  -H "Content-Type: application/json" \
  -d '{}'

json

{ "deleted": true }

POST/api/v1/access/sync

Sincronizar los accesos de una persona

Puerta única para WordPress, academias y webs propias. Activa o caduca pases usando IDs estables, une la identidad por email y evita que el Clon vuelva a vender lo que la persona ya posee.

Permiso de escritura

Cuerpo (JSON)

providerstringobligatorio

Identificador estable del conector.

account_idstringobligatorio

Identificador estable de la escuela o instalación.

modestringobligatorio

snapshot = foto completa actual; patch = solo los cambios incluidos.Valores: snapshot · patch

observed_atISO 8601obligatorio

Cuándo la plataforma observó este estado. Un evento más antiguo no pisa uno reciente.

event_idstring

Referencia opcional del webhook o entrega para auditoría.

personobjectobligatorio

Objeto con external_user_id y email; name es opcional.

accessesobject[] (0..200)obligatorio

Lista de cursos: external_product_id, status active/revoked y, opcionalmente, product_id, nombre, URL, alta y caducidad.

notifyboolean

Por defecto true. Prepara la bienvenida de los productos recién obtenidos; respeta el correo desactivado del producto. false la silencia.

trigger_automationsboolean

Por defecto true. Inicia las secuencias activas por etiqueta de alumno al ganar acceso. Para importar sin correos, enviar false junto con notify=false.

bash

curl -X POST "https://www.clonify.com/api/v1/access/sync" \
  -H "Authorization: Bearer clk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"provider":"…","account_id":"…","mode":"snapshot","observed_at":"2026-07-01T00:00:00Z","person":[{"…":"…"}],"accesses":[{"…":"…"}]}'

json

{
  "object": "access_sync",
  "provider": "wordpress",
  "account_id": "academia-principal",
  "mode": "snapshot",
  "received": 2,
  "activated": 2,
  "revoked": 1,
  "stale_ignored": 0,
  "unmapped": [],
  "follow_up": {
    "job_id": 123,
    "product_ids": [42, 43],
    "welcome_requested": true,
    "automations_requested": true,
    "status": "queued"
  }
}