> For the complete documentation index, see [llms.txt](https://docs.defguard.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.defguard.net/for-developers/rest-api/core/user/bulk-start-user-enrollment.md).

# Bulk start user enrollment

Disabled users are skipped and counted in the `skipped` response field. Already enrolled users are enrolled again. The request is rejected when any of the given IDs does not exist or is your own.

```json
{"openapi":"3.1.0","info":{"title":"defguard Core API","version":"2.0.3"},"tags":[{"name":"user","description":"User accounts, their MFA methods, enrollment and bulk operations."}],"security":[{"cookie":[]},{"api_token":[]}],"components":{"securitySchemes":{"cookie":{"type":"apiKey","in":"cookie","name":"defguard_session"},"api_token":{"type":"http","scheme":"bearer"}},"schemas":{"BulkStartEnrollmentRequest":{"type":"object","required":["users"],"properties":{"send_enrollment_notification":{"type":"boolean","description":"Whether to send enrollment email to each user (uses user's stored email)."},"token_expiration_time":{"type":["string","null"],"description":"Token expiration override in humantime format, for example `24h`. Falls back to the\nsystem setting."},"users":{"type":"array","items":{"$ref":"#/components/schemas/i64"}}}},"i64":{"type":"integer","format":"int64"},"ApiErrorResponse":{"type":"object","description":"Body returned with error responses.","required":["msg"],"properties":{"code":{"type":["string","null"],"description":"Machine-readable error code, returned for selected errors."},"msg":{"type":"string","description":"Human-readable error message."}}}}},"paths":{"/api/v1/user/bulk-start-enrollment":{"post":{"tags":["user"],"summary":"Bulk start user enrollment","description":"Disabled users are skipped and counted in the `skipped` response field. Already\nenrolled users are enrolled again. The request is rejected when any of the given IDs\ndoes not exist or is your own.","operationId":"bulk_start_enrollment","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkStartEnrollmentRequest"}}},"required":true},"responses":{"200":{"description":"Enrollment started.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"The list contains unknown user IDs or your own account.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Session is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"403":{"description":"Requires admin privileges.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Unable to start enrollments.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}}}}}}
```