Skip to main content

xAPI integration

Send learner starts, completions and published experiences to your Learning Record Store (LRS) with xAPI.

Written by Cody Iddings

Makeshapes tracks and reports on your published learning experiences. Our xAPI integration lets you capture detailed data about how learners interact with Makeshapes content and send it directly to your Learning Record Store (LRS).

Note: xAPI is available on selected plans, and Makeshapes switches it on for your organization.

What is xAPI?

xAPI (also called the Experience API or Tin Can API) is a modern learning technology standard. Think of it as a language that lets different systems talk about learning activities. Each event is sent as an "actor, verb, object" statement, like "Jane Doe completed Safety Experience."

How Makeshapes uses xAPI

When learners engage with your Makeshapes experiences, our platform automatically creates xAPI statements for key events. These statements get sent securely to your LRS endpoint.

What this means for your organization

  • Centralized learning data: Bring together learning data from Makeshapes and your other learning tools in one place: your LRS.

  • Better insights: Get richer data about learner progress, engagement patterns, and what content works best.

  • Stronger reporting: Use your LRS and business intelligence tools to create the reports you need.

  • Compliance and record keeping: Keep detailed, auditable records of all learning activities.

Learning events we track

Makeshapes sends xAPI statements for these important events:

Experience published

  • What it means: A new experience or learning module goes live in Makeshapes and becomes available to learners.

  • Data we send: Who published the experience (like a Makeshapes admin or the platform itself) plus details about the experience (ID, title, description, type). This helps your LRS recognize the experience when learners start using it.

Learner starts an experience

  • What it means: A learner registers and begins a Makeshapes experience as part of a group.

  • Data we send: Who the learner is, which experience they started, and when they started it. This marks the beginning of their learning session.

Learner completes an experience

  • What it means: A learner finishes a Makeshapes experience, alongside the rest of the group.

  • Data we send: Who completed it, which experience they finished, and a result showing successful completion.

Learner abandons an experience

  • What it means: Our system automatically generates this when a learner starts an experience but doesn't complete it within 31 days.

  • Data we send: Who the learner is and which experience they didn't finish within the expected time.

Setting up your xAPI integration

To get xAPI data flowing from Makeshapes to your LRS, you'll need to configure the integration in your Makeshapes settings.

What you'll need first

Get this information from your LRS administrator:

  1. Endpoint: the web address xAPI statements are sent to (like https://your-lrs.com/data/xapi/statements).

  2. Authentication method: whether your LRS uses Basic authentication or OAuth client credentials.

  3. Credentials: for Basic, a username and password (your LRS may call them an API key and secret). For OAuth, a token endpoint, client ID and client secret, and a scope if your LRS needs one.

Makeshapes identifies each learner by their email address, so your LRS will receive statements keyed to the email they registered with.

How to configure xAPI in Makeshapes

  1. Sign in to Makeshapes as an administrator and open Organisation settings.

  2. Open the Integrations tab. On the xAPI Integration card, click Set up integration (or Manage configuration if it's already set up).

  3. Enter the Endpoint.

  4. Under Authentication Method, choose Basic or OAuth, and enter the credentials for that method.

  5. Click Save configuration.

  6. Back on the card, click Test connection. You'll see "Connection successful" when Makeshapes can reach your LRS.

  7. Use the Enabled / Disabled toggle on the card to start or pause sending statements.

Don't see an Integrations tab? It only appears once Makeshapes has switched an integration on for your organization. Ask your Makeshapes contact to turn on xAPI.

Did this answer your question?