Developer docs

De Pluvo API geeft je programmatische toegang tot je leeromgeving. Beheer gebruikers, groepen, trainingen, inschrijvingen en certificaten vanuit je eigen systemen.

De API is gebaseerd op GraphQL. Je bepaalt zelf welke data je opvraagt of muteert, zonder overbodige velden. Authenticatie verloopt via OAuth 2.0 met client credentials. Webhooks houden je systemen real-time op de hoogte van wijzigingen.

Docs

Common Recipes

Recipe 1: Sync Users from HRM

A common integration pattern is syncing users from an HRM system to Pluvo. Use createUser with ref matching the HRM employee ID, and updateUser to keep data in sync.

mutation {
  createUser(user: {
    email: "employee@company.com"
    name: "Jane Doe"
    ref: "HRM-12345"
    sendMail: false
  }) {
    user { id ref }
  }
}

Recipe 2: Bulk Enrollment

Enroll all members of a group in an event:

mutation {
  createOfferEventEnrollments(
    offerEventId: "uuid"
    groupId: "group-uuid"
    sendMail: false
  ) {
    id user { name }
  }
}

Recipe 3: Progress Reporting

Export training progress for all users to sync with external systems.