/1/ Learner

Overview

The /1/learner endpoint provides for the creation of new users.

Beta API

NOTE: This API is currently in beta and applies only to the 'iFrame' API customers.

Key	Value	Example
User-Agent	<company identifier>	The exact value here is not important, but it should include something to identify your company
Accept	application/json
Authorization	Bearer <your token>	Bearer wV1MLkss5+sFzioJw/3M5r9A==
(Optional) Learner ID	X-UserId: ID	This will attach the Learner to this User (so if you have a User who want's to create a Learner under his account/org you would add their userid.

Code Example

curl --location 'https://api-sandbox.vbmappapp.com/1/learner' \
--header 'X-UserId: ID' \
--header 'Content-Type: application/json' \
--header 'Authorization: ••••••' \
--data '{
  "code": "subsdsads",
  "firstName": "subadasd",
  "lastName":  "learner",
  "color": "#ffff",
  "gender": 1,
  "isActive": 1,
  "dateOfBirth": "2014-02-01"
}
'

Example response

[
    {
        "id": 19353,
        "code": "subsdsads",
        "color": null,
        "dateOfBirth": "2014-02-01",
        "firstName": "subadasd",
        "lastName": "learner",
        "gender": 1,
        "isActive": 1,
        "createdAt": "2025-06-02 11:29:20",
        "updatedAt": "2025-06-02 04:54:35",
        "organizationId": 259,
        "parent": null,
        "userId": null,
        "reportsGenerated": 0,
        "v2id": null
    },
    {
        "id": 19354,
        "code": "new",
        "color": null,
        "dateOfBirth": "2014-02-01",
        "firstName": "larner",
        "lastName": "one",
        "gender": 1,
        "isActive": 1,
        "createdAt": "2025-06-02 11:51:22",
        "updatedAt": "2025-06-02 05:37:10",
        "organizationId": 259,
        "parent": null,
        "userId": null,
        "reportsGenerated": 0,
        "v2id": null
    },
]