# Start training enrollment for a customer As a Reseller you can create and send a training enrollment for a customer's target users. The flow: get the customer's Company ID, find the training and target group, create the enrollment, and send it. Use a credential with Client Role = **Reseller**. Send **`X-KEEPNET-Company-Id`** with every request. *** ## POST /api/companies/search > Get the customer's Company ID first. Use the `resourceId` from the response as **`X-KEEPNET-Company-Id`** in all subsequent requests. **Test it:** Authorize with Client ID/Secret, then Send — request body is pre-filled. {% openapi src="" path="/api/companies/search" method="post" expanded="true" %} [keepnet-api-spec.json](https://3453589210-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LMcQ_WCXOrHv3r05ae5%2Fuploads%2Fgit-blob-2ac60b0c4cde16618010aa24bba98c69325f869e%2Fkeepnet-api-spec.json?alt=media) {% endopenapi %} *** ## POST /api/trainings/search > List available trainings. Send **`X-KEEPNET-Company-Id`**. Use the `resourceId` of the desired training as `trainingId` when creating the enrollment. {% openapi src="" path="/api/trainings/search" method="post" expanded="true" %} [keepnet-api-spec.json](https://3453589210-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LMcQ_WCXOrHv3r05ae5%2Fuploads%2Fgit-blob-2ac60b0c4cde16618010aa24bba98c69325f869e%2Fkeepnet-api-spec.json?alt=media) {% endopenapi %} *** ## POST /api/target-groups/search/current-company > List target groups available for the customer. Send **`X-KEEPNET-Company-Id`**. Use one or more `resourceId` values as `targetGroupResourceIds` in the enrollment. {% openapi src="" path="/api/target-groups/search/current-company" method="post" expanded="true" %} [keepnet-api-spec.json](https://3453589210-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LMcQ_WCXOrHv3r05ae5%2Fuploads%2Fgit-blob-2ac60b0c4cde16618010aa24bba98c69325f869e%2Fkeepnet-api-spec.json?alt=media) {% endopenapi %} *** ## GET /api/enrollments/form-details > Returns dropdown data (enrollment types, certificate options, reminder config, etc.) needed to build the enrollment create request. Send **`X-KEEPNET-Company-Id`**. {% openapi src="" path="/api/enrollments/form-details" method="get" expanded="true" %} [keepnet-api-spec.json](https://3453589210-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LMcQ_WCXOrHv3r05ae5%2Fuploads%2Fgit-blob-2ac60b0c4cde16618010aa24bba98c69325f869e%2Fkeepnet-api-spec.json?alt=media) {% endopenapi %} *** ## POST /api/enrollments > Creates a new enrollment for the customer. Send **`X-KEEPNET-Company-Id`**. Body: `trainingId` (from trainings/search), `name`, `targetGroupResourceIds`, scheduling config, and optional fields (certificate, reminder, etc.). See Endpoints → **Enrollment** for the full schema. {% openapi src="" path="/api/enrollments" method="post" expanded="true" %} [keepnet-api-spec.json](https://3453589210-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LMcQ_WCXOrHv3r05ae5%2Fuploads%2Fgit-blob-2ac60b0c4cde16618010aa24bba98c69325f869e%2Fkeepnet-api-spec.json?alt=media) {% endopenapi %} Example body (minimal): ```json { "trainingId": "", "name": "Q1 Security Awareness Training", "targetGroupResourceIds": [""], "enrollmentScheduler": { "scheduledDate": "2026-04-01T09:00:00Z", "scheduledTimeZoneId": "Europe/Istanbul", "useOwnTimeZone": false, "dueDate": "2026-04-30T23:59:59Z" }, "awardCertificate": true, "markedAsTest": false, "sendTeamsNotification": false } ``` From the response, note the enrollment `resourceId`. Use it to send the enrollment. *** ## POST /api/enrollments/{resourceId}/send > Sends the enrollment immediately to all assigned target users. Replace `{resourceId}` with the enrollment ID from the create response. Send **`X-KEEPNET-Company-Id`**. No request body — just POST to the URL. {% openapi src="" path="/api/enrollments/{resourceId}/send" method="post" expanded="true" %} [keepnet-api-spec.json](https://3453589210-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LMcQ_WCXOrHv3r05ae5%2Fuploads%2Fgit-blob-2ac60b0c4cde16618010aa24bba98c69325f869e%2Fkeepnet-api-spec.json?alt=media) {% endopenapi %} *** ## Common errors * **403 Forbidden** — Credential is not Reseller, or the Company ID is not one you manage. Set Client Role = **Reseller**. [Roles and permissions →](https://doc.keepnetlabs.com/next-generation-product/platform/company/system-users/user-roles) * **401 Unauthorized** — Missing or invalid token. Request a new token via `POST /connect/token`. * **400 Bad Request** — Invalid request body. Verify `trainingId` from `POST /api/trainings/search`, `targetGroupResourceIds` from `POST /api/target-groups/search/current-company`, and check Endpoints → **Enrollment** for the full schema. * **404 Not Found** — Invalid Company ID, training ID, or enrollment ID. {% hint style="info" %} **Platform UI:** Create enrollments under **Awareness Educator → Enrollments**. [Enrollments →](https://doc.keepnetlabs.com/next-generation-product/platform/awareness-educator/enrollments) {% endhint %} **Related:** [View customer's enrollment list and report →](https://doc.keepnetlabs.com/api-reference/reseller/training/view-customer-enrollment-list-and-report). [Scope API requests to a customer →](https://doc.keepnetlabs.com/api-reference/reseller/companies/scope-api-requests-to-customer).