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

# Upload and review a group member CSV

> Uploads a CSV in the file field of a multipart/form-data request, up to 10 MiB and 5000 data rows. The CSV must contain a column named exactly email. Addresses are trimmed, lowercased, and matched to active company employees. Returns full accepted and rejected counts, up to 50 preview rows of each kind, and an uploadId. This step does not change membership. Requires permission to read and edit a MANUAL group. Only the employee who uploaded the file can submit it, and only for this group.



## OpenAPI

````yaml https://api.gowindmill.com/api/v2/openapi.json post /c/{companyId}/groups/{groupId}/members/imports/uploads
openapi: 3.1.0
info:
  title: Windmill API
  version: 2.0.0
  description: >-
    Use the Windmill API to integrate your systems, automate workflows, and
    build applications on your organization's data. Authenticate with an API key
    or OAuth access token. Each request uses the authenticated user's
    permissions within the selected workspace.
servers:
  - url: https://api.gowindmill.com/api/v2
security:
  - bearerAuth: []
paths:
  /c/{companyId}/groups/{groupId}/members/imports/uploads:
    post:
      tags:
        - Groups
      summary: Upload and review a group member CSV
      description: >-
        Uploads a CSV in the file field of a multipart/form-data request, up to
        10 MiB and 5000 data rows. The CSV must contain a column named exactly
        email. Addresses are trimmed, lowercased, and matched to active company
        employees. Returns full accepted and rejected counts, up to 50 preview
        rows of each kind, and an uploadId. This step does not change
        membership. Requires permission to read and edit a MANUAL group. Only
        the employee who uploaded the file can submit it, and only for this
        group.
      operationId: groups.memberImports.upload
      parameters:
        - schema:
            type: string
            minLength: 1
            maxLength: 128
            description: >-
              Company ID. A URL slug is also accepted. The caller must have
              access to this company.
            title: Company ID
            example: company-acme
          required: true
          description: >-
            Company ID. A URL slug is also accepted. The caller must have access
            to this company.
          name: companyId
          in: path
        - schema:
            type: string
            description: Opaque employee group identifier in this company.
            title: Employee group ID
            example: group-engineering
          required: true
          description: Opaque employee group identifier in this company.
          name: groupId
          in: path
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              title: Group member CSV upload
              type: object
              properties:
                file:
                  type: string
                  format: binary
                  title: CSV file
                  description: >-
                    CSV file with an email header, up to 10 MiB and 5000 data
                    rows.
              required:
                - file
              description: Multipart CSV upload in the "file" field, up to 10 MiB.
      responses:
        '200':
          description: Upload ID, validated rows and errors.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EmployeeGroupImportUploadResponse'
        '400':
          description: Bad request or request validation failed
          content:
            application/json:
              schema:
                anyOf:
                  - type: object
                    properties:
                      error:
                        type: object
                        properties:
                          code:
                            type: string
                            enum:
                              - BAD_REQUEST
                          message:
                            type: string
                          requestId:
                            type: string
                        required:
                          - code
                          - message
                          - requestId
                    required:
                      - error
                  - type: object
                    properties:
                      error:
                        type: object
                        properties:
                          code:
                            type: string
                            enum:
                              - VALIDATION_ERROR
                          message:
                            type: string
                          requestId:
                            type: string
                          details:
                            type: array
                            items:
                              type: object
                              properties:
                                path:
                                  type: array
                                  items:
                                    anyOf:
                                      - type: string
                                      - type: number
                                message:
                                  type: string
                              required:
                                - path
                                - message
                        required:
                          - code
                          - message
                          - requestId
                          - details
                    required:
                      - error
        '401':
          description: >-
            Authentication is missing or invalid. Send a valid API key or OAuth
            access token in the Authorization: Bearer <TOKEN> header before
            retrying.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        enum:
                          - UNAUTHORIZED
                      message:
                        type: string
                      requestId:
                        type: string
                    required:
                      - code
                      - message
                      - requestId
                required:
                  - error
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        enum:
                          - FORBIDDEN
                      message:
                        type: string
                      requestId:
                        type: string
                    required:
                      - code
                      - message
                      - requestId
                required:
                  - error
        '404':
          description: Not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        enum:
                          - NOT_FOUND
                      message:
                        type: string
                      requestId:
                        type: string
                    required:
                      - code
                      - message
                      - requestId
                required:
                  - error
        '429':
          description: >-
            The API-client request budget is exhausted. API keys allow 500
            requests per minute per key; OAuth clients allow 500 per minute per
            client and workspace. Reads and writes share the budget. One HTTP
            request counts once, including bulk requests. Wait for the
            Retry-After delay before retrying.
          headers:
            Retry-After:
              description: Number of seconds to wait before retrying the request.
              required: true
              schema:
                type: integer
                minimum: 0
                example: 42
            RateLimit:
              description: >-
                Current request budget: limit is the maximum count, remaining is
                the unused count, and reset is seconds until the window resets,
                not a timestamp.
              required: true
              schema:
                type: string
                example: limit=500, remaining=0, reset=42
            RateLimit-Policy:
              description: >-
                Request limit and window length in seconds, formatted as
                <limit>;w=<seconds>.
              required: true
              schema:
                type: string
                example: 500;w=60
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        enum:
                          - RATE_LIMITED
                      message:
                        type: string
                      requestId:
                        type: string
                    required:
                      - code
                      - message
                      - requestId
                required:
                  - error
      security:
        - bearerAuth: []
components:
  schemas:
    EmployeeGroupImportUploadResponse:
      allOf:
        - $ref: '#/components/schemas/EmployeeGroupImportReview'
        - type: object
          properties:
            uploadId:
              type: string
              format: uuid
              description: >-
                UUID returned by upload review. The upload is scoped to the
                company, group, and uploading employee.
              title: Upload ID
              example: 22222222-2222-4222-8222-222222222222
          required:
            - uploadId
      title: CSV upload response
      description: Review results plus the upload ID used to submit this import.
      example:
        total: 1
        accepted: 1
        rejected: 0
        ready:
          - row: 2
            email: avery@example.test
            employee:
              id: employee-avery
              name: Avery Chen
              avatarUrl: null
              jobTitle: Engineer
        errors: []
        uploadId: 22222222-2222-4222-8222-222222222222
    EmployeeGroupImportReview:
      type: object
      properties:
        total:
          type: number
          description: Total CSV data rows reviewed, excluding the header.
          title: Total matches
          example: 1
        accepted:
          type: number
          description: >-
            Number of CSV rows that currently resolve to an active employee in
            the company.
          title: Accepted rows
          example: 1
        rejected:
          type: number
          description: >-
            Number of rejected CSV rows; in job status, the number of processed
            rows that failed.
          title: Rejected rows
          example: 0
        ready:
          type: array
          items:
            type: object
            properties:
              row:
                type: integer
                description: >-
                  One-based CSV row number, including the header. The first data
                  row is 2.
                title: CSV row number
                example: 2
              email:
                type: string
                description: >-
                  Employee email address. CSV input is trimmed and lowercased
                  before matching.
                title: Email address
                example: avery@example.test
              employee:
                type:
                  - object
                  - 'null'
                properties:
                  id:
                    type: string
                    description: Opaque employee identifier in this company.
                    title: Employee ID
                    example: employee-avery
                  name:
                    type: string
                    description: Resolved employee display name.
                    title: Employee name
                    example: Avery Chen
                  avatarUrl:
                    type:
                      - string
                      - 'null'
                    description: Avatar URL, or null when no avatar is available.
                    title: Avatar URL
                    example: null
                  jobTitle:
                    type:
                      - string
                      - 'null'
                    description: Recorded employee job title, or null when unavailable.
                    title: Job title
                    example: Engineer
                required:
                  - id
                  - name
                  - avatarUrl
                  - jobTitle
                description: >-
                  Matched employee summary, or null when unavailable during
                  review.
                title: Matched employee
            required:
              - row
              - email
              - employee
          description: >-
            First 50 accepted CSV rows, with matched employee summaries. This is
            a preview rather than the full import.
          title: Accepted row preview
        errors:
          type: array
          items:
            $ref: '#/components/schemas/EmployeeGroupImportRowError'
          description: >-
            First 50 rejected or failed rows. The rejected count can exceed the
            length of this preview.
          title: Row errors
          example: []
      required:
        - total
        - accepted
        - rejected
        - ready
        - errors
      title: CSV review
      description: Full row counts and up to 50 accepted and rejected row previews.
      example:
        total: 1
        accepted: 1
        rejected: 0
        ready:
          - row: 2
            email: avery@example.test
            employee:
              id: employee-avery
              name: Avery Chen
              avatarUrl: null
              jobTitle: Engineer
        errors: []
    EmployeeGroupImportRowError:
      type: object
      properties:
        row:
          type: integer
          description: >-
            One-based CSV row number, including the header. The first data row
            is 2.
          title: CSV row number
          example: 2
        email:
          type:
            - string
            - 'null'
          description: >-
            Email text as submitted in the CSV, or null when missing or
            unavailable.
          title: Email address
          example: avery@example.test
        error:
          type:
            - string
            - 'null'
          description: >-
            Explanation of a rejected row or failed sync. Null or absence means
            no error is recorded.
          title: Error message
      required:
        - row
        - email
        - error
      title: Import row error
      description: A rejected CSV data row.
      example:
        row: 2
        email: missing@example.test
        error: No active employee matches this email
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Use an API key or OAuth access token. Enter only the token in the
        authorization dialog; requests send it as `Authorization: Bearer
        <TOKEN>`.


        Create an API key in your workspace's **Settings → API keys**. Keys
        start with `wm_api_` and only work in the workspace where they were
        created. Read-only keys can read data; creating, updating, or deleting
        data requires a read-write key.


        ```http

        Authorization: Bearer wm_api_example

        ```


        OAuth access tokens are issued for connected Windmill applications.


        ```http

        Authorization: Bearer <OAUTH_ACCESS_TOKEN>

        ```


        Both token types use the authenticated user's workspace permissions.
        Each endpoint's permission requirements and the sharing settings of the
        requested items still apply.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.