Training Records via the API

How to Handle Training Record Data

intelliHR training records each hold a status. intelliHR makes it possible to track trainings for employees, including things like the course type, hours invested and so on.

Typically, if you’re building an integration to our trainings feature from your Learning Management System, the flow of data will look like this:

1. Employee completes training in LMS

2. Completed training/course webhook fires

3. POST to save completed training information against employee in intelliHR

If you’re API doesn’t have webhooks or events, you can always perform multiple POST requests in bulk on our API.

Training Statuses

intelliHR training records each hold a status. The status represent the progress of the training. A list of training statuses can be retrieved from the List all Training Stauses endpoint: https://developers.intellihr.io/docs/v1/#tag/Training-Statuses/paths/~1training-statuses/get

Statuses can be sent as an Id or name when creating or updating a training record. Current statuses include:

1. Enrolled
2. In Progress
3. Completed
4. Did Not Complete

<aside> 💡 Training status will default to “Enrolled” if not provided, so if you are only sending completed trainings, we recommend hard coding the status to “Completed”

</aside>

Creating a Training Record

Creating a training record in intelliHR via the API is done by making an HTTP POST request to the /trainings endpoint.

"url": <https://api.intellihr.io/v1/trainings>

"method": 'POST'

"headers": {
        "Content-Type": 'application/json',
        "Accept": 'application/json',
        "Authorization": `Bearer ${apikey}`,
        "Tenant": tenantname
  }

"body": {
    "coordinatorPerson": {
        "id": "8a5f3ea6-ea6b-4425-8a87-3c256bb7b6f9",
        "name": "Bruce Wayne",
        "primaryEmailAddress": "[e-mail]",
        "employeeNumber": "00001",
        "autoIncrementIntellihrId": "1000"
    },
    "completionDate": "2015-03-01T22:30:00+00:00",
    "cost": "600",
    "currency": "AUD",
    "hours": "12",
    "job": {
        "id": "8a5f3ea6-ea6b-4425-8a87-3c256bb7b6f9"
    },
    "name": "Accounting Compliance 101",
    "person": {
        "id": "8a5f3ea6-ea6b-4425-8a87-3c256bb7b6f9",
        "name": "Bruce Wayne",
        "primaryEmailAddress": "[e-mail]",
        "employeeNumber": "00001",
        "autoIncrementIntellihrId": "1000"
    },
    "provider": {
        "id": "8a5f3ea6-ea6b-4425-8a87-3c256bb7b6f9",
        "name": "HR Training Team"
    },
    "type": {
        "id": "8a5f3ea6-ea6b-4425-8a87-3c256bb7b6f9",
        "name": "Soft Skills"
    },
    "status": {
        "id": "8a5f3ea6-ea6b-4425-8a87-3c256bb7b6f9",
        "name": "Completed"
    }
}

Updating a Training Record

Creating a training record in intelliHR via the API is done by making an HTTP POST request to the /trainings endpoint.