---
title: "Create a training record"
method: POST
path: "/trainings"
tags: ["Trainings"]
---

# Create a training record

`POST /trainings`

## Request

- Base URL: `https://api.intellihr.io`
- URL: `https://api.intellihr.io/trainings`
- Auth: API key in header `Authorization`

Create a training record for a Person. 

IMPORTANT: Please note that workflows will NOT be automatically triggered as a result of creating Training using this API endpoint, although it will return the required information to manually trigger it. 

To trigger the workflows manually, use the intelliHR platform. 

Automatic workflow triggering will be added in the future, please contact <a href="mailto:support@intellihr.co">support@intellihr.co</a> with any questions.

## Request body

- TrainingsCreateRequest
  - `id` ResourceId (unresolved $ref)
  - `typeId` ResourceId, required (unresolved $ref)
  - `personId` ResourceId, required (unresolved $ref)
  - `jobId` ResourceId, required (unresolved $ref)
  - `providerId` ResourceId, required (unresolved $ref)
  - `name` string, required: Name given to this [Training](#tag/Trainings)
  - `hours` string: How many hours were spent on this [Training](#tag/Trainings)
  - `currency` Currency, required (unresolved $ref)
  - `cost` string: The cost of this [Training](#tag/Trainings)
  - `coordinatorPersonId` ResourceId, required (unresolved $ref)
  - `completionDate` RfcDateTime, required (unresolved $ref)
  - `customFields` CustomFieldsRequest (unresolved $ref)

## Response `201`

Created Successfully

- Trainings
  - `data` object
    - `type` string: The name of the data model that is being returned
    - `id` ResourceId (unresolved $ref)
    - `attributes` object
      - `name` string: Name given to this [Training](#tag/Trainings)
      - `personId` ResourceId (unresolved $ref)
      - `personName` string: The name of the [Person](#tag/People) who did the [Training](#tag/Trainings)
      - `jobId` ResourceId (unresolved $ref)
      - `jobName` string: The name of the [Job](#tag/Jobs) that this [Training](#tag/Trainings) was completed for
      - `coordinatorPersonId` ResourceId (unresolved $ref)
      - `coordinatorPersonName` string: The name of the [Person](#tag/People) who coordinated the [Training](#tag/Trainings)
      - `hours` string: How many hours were spent on this [Training](#tag/Trainings)
      - `cost` string: The cost of this [Training](#tag/Trainings)
      - `currency` Currency (unresolved $ref)
      - `providerId` ResourceId (unresolved $ref)
      - `providerName` string: The name of the [Training Provider](#tag/Training-Types) for this [Training](#tag/Trainings)
      - `typeId` ResourceId (unresolved $ref)
      - `typeName` string: The name of the [Training Type](#tag/Training-Types) for this [Training](#tag/Trainings)
      - `completionDate` RfcDateTime (unresolved $ref)
      - `createdAt` RfcDateTime (unresolved $ref)
      - `updatedAt` RfcDateTime (unresolved $ref)
      - `customFields` CustomFieldsResponse (unresolved $ref)

## Other responses

- `400` (unresolved $ref)
- `403` (unresolved $ref)
- `500` (unresolved $ref)

---

[API](https://skmtc.dev/intellihr/apis/intellihr-public-api.md) · [All operations](https://skmtc.dev/intellihr/apis/intellihr-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/intellihr/apis/intellihr-public-api/revisions/6529279c999b?raw)
