Accessos d'acadèmies

GET/api/v1/access/mappings

Llistar relacions de cursos externs

Retorna el diccionari que tradueix els IDs estables d'una acadèmia als teus Products de Clonify.

Paràmetres de consulta

providerstring

Filtra per plataforma o connector.

account_idstring

Filtra per l'escola concreta dins d'aquesta plataforma.

bash

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

POST/api/v1/access/mappings

Relacionar un curs extern

Crea o canvia la relació entre un curs de l'acadèmia i un Product del teu compte. És idempotent per plataforma, compte i ID extern.

Permís d'escriptura

Cos (JSON)

providerstringobligatori

Identificador estable del connector, per exemple wordpress o custom_web.

account_idstringobligatori

Identificador estable de l'escola o instal·lació.

external_product_idstringobligatori

ID immutable del curs a l'acadèmia; no facis servir mai el títol.

external_product_namestring

Nom visible, només per a diagnòstic.

product_idintegerobligatori

ID del Product corresponent a Clonify.

access_urlstring

URL opcional on l'alumne obre el curs. Ha de 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

Treure una relació de curs

Elimina el diccionari; no esborra l'historial d'accessos ja rebut.

Permís d'esborrat

Paràmetres de consulta

providerstringobligatori

Plataforma o connector de la relació.

account_idstringobligatori

Escola concreta de la relació.

external_product_idstringobligatori

ID estable del curs extern.

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

Sincronitzar els accessos d'una persona

Porta única per a WordPress, acadèmies i webs pròpies. Activa o caduca passis amb IDs estables, uneix la identitat per email i evita que el Clon torni a vendre el que la persona ja té.

Permís d'escriptura

Cos (JSON)

providerstringobligatori

Identificador estable del connector.

account_idstringobligatori

Identificador estable de l'escola o instal·lació.

modestringobligatori

snapshot = foto completa actual; patch = només els canvis inclosos.Valors: snapshot · patch

observed_atISO 8601obligatori

Quan la plataforma va observar aquest estat. Un esdeveniment antic no en trepitja un de recent.

event_idstring

Referència opcional del webhook o lliurament per a auditoria.

personobjectobligatori

Objecte amb external_user_id i email; name és opcional.

accessesobject[] (0..200)obligatori

Llista de cursos: external_product_id, status active/revoked i, opcionalment, product_id, nom, URL, alta i caducitat.

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"
  }
}

Accessos d'acadèmies

GET/api/v1/access/mappings

Llistar relacions de cursos externs

Retorna el diccionari que tradueix els IDs estables d'una acadèmia als teus Products de Clonify.

Paràmetres de consulta

providerstring

Filtra per plataforma o connector.

account_idstring

Filtra per l'escola concreta dins d'aquesta plataforma.

bash

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

POST/api/v1/access/mappings

Relacionar un curs extern

Crea o canvia la relació entre un curs de l'acadèmia i un Product del teu compte. És idempotent per plataforma, compte i ID extern.

Permís d'escriptura

Cos (JSON)

providerstringobligatori

Identificador estable del connector, per exemple wordpress o custom_web.

account_idstringobligatori

Identificador estable de l'escola o instal·lació.

external_product_idstringobligatori

ID immutable del curs a l'acadèmia; no facis servir mai el títol.

external_product_namestring

Nom visible, només per a diagnòstic.

product_idintegerobligatori

ID del Product corresponent a Clonify.

access_urlstring

URL opcional on l'alumne obre el curs. Ha de 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

Treure una relació de curs

Elimina el diccionari; no esborra l'historial d'accessos ja rebut.

Permís d'esborrat

Paràmetres de consulta

providerstringobligatori

Plataforma o connector de la relació.

account_idstringobligatori

Escola concreta de la relació.

external_product_idstringobligatori

ID estable del curs extern.

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

Sincronitzar els accessos d'una persona

Porta única per a WordPress, acadèmies i webs pròpies. Activa o caduca passis amb IDs estables, uneix la identitat per email i evita que el Clon torni a vendre el que la persona ja té.

Permís d'escriptura

Cos (JSON)

providerstringobligatori

Identificador estable del connector.

account_idstringobligatori

Identificador estable de l'escola o instal·lació.

modestringobligatori

snapshot = foto completa actual; patch = només els canvis inclosos.Valors: snapshot · patch

observed_atISO 8601obligatori

Quan la plataforma va observar aquest estat. Un esdeveniment antic no en trepitja un de recent.

event_idstring

Referència opcional del webhook o lliurament per a auditoria.

personobjectobligatori

Objecte amb external_user_id i email; name és opcional.

accessesobject[] (0..200)obligatori

Llista de cursos: external_product_id, status active/revoked i, opcionalment, product_id, nom, URL, alta i caducitat.

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"
  }
}