> ## Documentation Index > Fetch the complete documentation index at: https://help.doozy.live/llms.txt > Use this file to discover all available pages before exploring further. # Enroll user in track > Enroll a user in a track. The user must be connected to Slack and have at least one role assigned. Exactly one of email, user_id, or slack_user_id must be provided to identify the user. ## OpenAPI ````yaml /openapi.json post /v1/tracks/{trackId}/enroll openapi: 3.0.3 info: title: Doozy Public API version: 1.0.0 description: >- The Doozy Public API allows you to programmatically access your organization's data. ## Authentication All API requests require an API key passed in the `x-api-key` header. ``` x-api-key: dzy_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx ``` API keys can be generated and managed through the Doozy dashboard. Each key is associated with a user account and inherits that user's permissions. ## Rate Limiting API requests are rate limited. Rate limiting is handled by Cloudflare. If you exceed the rate limit, you'll receive a 429 Too Many Requests response. ## Pagination List endpoints support cursor-based pagination using `limit` and `starting_after` query parameters. contact: name: Doozy Support email: support@doozy.live url: https://help.doozy.live/api servers: - url: https://api.doozy.live description: Production security: - apiKey: [] tags: - name: Quizzes description: Quiz analytics and reporting endpoints - name: Tracks description: Track management and analytics endpoints - name: Surveys description: Survey and poll analytics endpoints - name: Introductions description: Doozy Roulette and Matchmaking introduction endpoints paths: /v1/tracks/{trackId}/enroll: post: tags: - Tracks summary: Enroll user in track description: >- Enroll a user in a track. The user must be connected to Slack and have at least one role assigned. Exactly one of email, user_id, or slack_user_id must be provided to identify the user. parameters: - schema: type: string description: The unique identifier of the track example: wf_abc123xyz required: true description: The unique identifier of the track name: trackId in: path requestBody: content: application/json: schema: $ref: '#/components/schemas/EnrollUserBody' responses: '201': description: User successfully enrolled in track content: application/json: schema: $ref: '#/components/schemas/EnrollUserResponse' '400': description: >- Invalid request - missing identifier, user not connected to Slack, or user missing roles content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Authentication required - missing API key content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: Invalid API key or insufficient permissions content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: Track not found, user does not have access, or user not found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '409': description: >- Conflict - user is already enrolled or has already completed the track content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - apiKey: [] components: schemas: EnrollUserBody: type: object properties: email: type: string format: email description: The email address of the user to enroll example: user@example.com user_id: type: string description: The Doozy user ID of the user to enroll example: abc123 slack_user_id: type: string description: The Slack user ID of the user to enroll example: U01ABC2DEF3 allow_already_completed: type: boolean default: false description: >- Allow enrolling a user who has previously completed this track. Defaults to false. example: false start_at: type: string format: date-time description: >- ISO 8601 timestamp for when the user should start the track. Defaults to now. Can be set to a future date to schedule enrollment. example: '2026-02-20T09:00:00.000Z' EnrollUserResponse: type: object properties: object: type: string enum: - track_enrollment description: The object type example: track_enrollment track_id: type: string description: The ID of the track the user was enrolled in example: wf_abc123xyz user_id: type: string description: The Doozy user ID of the enrolled user example: usr_abc123 instance_id: type: string description: The ID of the workflow instance created for this enrollment example: inst_xyz789 status: type: string enum: - active description: The status of the enrollment example: active enrolled_at: type: string description: ISO 8601 timestamp of when the user was enrolled example: '2026-02-18T10:30:00.000Z' starts_at: type: string description: >- ISO 8601 timestamp of when the user will start the track (may be in the future if scheduled) example: '2026-02-20T09:00:00.000Z' required: - object - track_id - user_id - instance_id - status - enrolled_at - starts_at ErrorResponse: type: object properties: error: type: object properties: type: type: string enum: - api_error - authentication_error - invalid_request_error - rate_limit_error description: The type of error returned example: invalid_request_error code: type: string nullable: true description: Machine-readable error code for specific error conditions example: resource_not_found message: type: string description: Human-readable error message example: 'No such quiz: quiz_abc123' param: type: string nullable: true description: The parameter related to the error, if applicable example: id doc_url: type: string format: uri description: URL to documentation about this error example: https://docs.doozy.live/api/errors#resource_not_found required: - type - code - message required: - error securitySchemes: apiKey: type: apiKey in: header name: x-api-key description: API key for authentication. Generate keys in the Doozy dashboard. ````