> ## Documentation Index
> Fetch the complete documentation index at: https://anaconda.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Onboard Users

> Onboards users by adding them to your organization, assigning seats, and generating organization access tokens.

Administrators receive an email confirming the users were added.

Users receive a welcome email and a separate email containing their organization access token.

<Warning>
  If a user already has an Anaconda account associated with their email address, automated onboarding will fail for that user.

  If the number of available seats is less than the number of users you are attempting to add, users are added until seats are no longer available, and remaining users appear in `users_unavailable_for_onboarding`.
</Warning>


## OpenAPI

````yaml POST /api/v1/organizations/{org_id}/users_auto_registration
openapi: 3.1.0
info:
  title: Organization Management API
  version: 1.0.0
servers:
  - url: https://anaconda.com
    description: Anaconda Cloud
security: []
paths:
  /api/v1/organizations/{org_id}/users_auto_registration:
    post:
      tags:
        - organizations
      summary: Onboard Users
      description: >-
        Onboards users by adding them to your organization, assigning seats, and
        generating organization access tokens.
      operationId: auto_register_users
      parameters:
        - name: org_id
          in: path
          required: true
          schema:
            type: string
          description: >-
            Your organization ID, found in your organization's URL:
            `anaconda.com/app/organizations/<ORG_ID>/`.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateOrganizationManagedUsersRequest'
      responses:
        '200':
          description: Onboarding results
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AutoRegistrationResponse'
        '422':
          description: Validation error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - JWT or Access Token: []
components:
  schemas:
    CreateOrganizationManagedUsersRequest:
      type: object
      required:
        - user_emails
      properties:
        user_emails:
          type: array
          items:
            type: string
            format: email
          description: A list of email addresses for the users to onboard.
    AutoRegistrationResponse:
      type: object
      properties:
        users_in_onboarding_process:
          type: array
          items:
            type: string
          description: >-
            Email addresses of users that were successfully queued for
            onboarding.
        users_unavailable_for_onboarding:
          type: array
          items:
            type: string
          description: >-
            Email addresses of users that could not be onboarded (for example,
            because they already have an account or no seats are available).
        total_organization_seats:
          type: string
          description: The total number of seats in your organization's subscription.
        available_organization_seats:
          type: string
          description: The number of remaining unassigned seats.
    HTTPValidationError:
      type: object
      properties:
        detail:
          type: array
          description: A list of validation errors.
          items:
            $ref: '#/components/schemas/ValidationError'
    ValidationError:
      type: object
      required:
        - loc
        - msg
        - type
      properties:
        loc:
          type: array
          items:
            type: string
          description: >-
            The location of the validation error (for example, `["body",
            "name"]`).
        msg:
          type: string
          description: A human-readable validation error message.
        type:
          type: string
          description: The type of validation error.
  securitySchemes:
    JWT or Access Token:
      bearerFormat: JWT
      description: >-
        Bearer token obtained by authenticating with [service
        account](/anaconda-platform/admin/service-accounts) credentials
        (`client_id` and `client_secret`).


        See the [Getting
        started](/anaconda-platform/admin/org-management-api/org-management-api)
        page for the full authentication flow.
      scheme: bearer
      type: http

````