> ## 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.

# Add User

> Adds a user to the organization.

<Note>
  Provide an email address to add the user as a standard organization member.

  Omitting an email address creates an organization-managed user instead.

  Managed users are not linked to individual accounts and are intended for programmatic use, such as generating tokens for automated processes or integrations.
</Note>


## OpenAPI

````yaml POST /api/v1/organizations/{org_id}/users
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:
    post:
      tags:
        - organizations
      summary: Add User
      description: Adds a user to the organization.
      operationId: add_user
      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/CreateOrganizationManagedUserRequest'
      responses:
        '200':
          description: User added successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedUser'
        '422':
          description: Validation error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - JWT or Access Token: []
components:
  schemas:
    CreateOrganizationManagedUserRequest:
      type: object
      properties:
        email:
          type:
            - string
            - 'null'
          format: email
          description: >-
            The email address for the new user. If omitted, an
            organization-managed user is created instead.
        first_name:
          type:
            - string
            - 'null'
          description: >-
            The first name of the user. For managed users, use a descriptive
            name for the token's intended purpose.
        last_name:
          type:
            - string
            - 'null'
          description: >-
            The last name of the user. For managed users, use a descriptive name
            for the token's intended purpose.
    ManagedUser:
      type: object
      required:
        - id
      properties:
        id:
          type: string
          description: The unique identifier for the created user.
        email:
          type:
            - string
            - 'null'
          format: email
          description: The email address of the user.
        first_name:
          type:
            - string
            - 'null'
          description: The first name of the user.
        last_name:
          type:
            - string
            - 'null'
          description: The last name of the user.
    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

````