---
title: "Import Users"
method: POST
path: "/v1/publishers/users"
tags: ["Server-Side"]
---

# Import Users

`POST /v1/publishers/users`

Bulk imports given user accounts. This feature must be enabled by your account manager!
If more than one user is sent in a request, that request is treated as a bulk import. Only
one bulk import can be issued at a time. If only one user is set, you can call the endpoint in
parallel.

## Request body

- ImportUsersBody
  - `users` ImportUser[], required
    - `uid` string, required
    - `zipcode` string
    - `birthdate` string, required
    - `gender` 'MALE' | 'FEMALE' | 'OTHER', required
    - `questions` ImportUserQuestion[], required
      - `id` string, required
      - `network_id` integer — Should be left empty/null.
      - `direct_values` string[], required
    - `username` string — Allows specifying a display name for the requesting user which is used for features such as the leaderboard. Only alpha-numeric characters are allowed.

## Response `200`

OK

- object
  - `data` ImportUsersResponse
    - `success_count` integer, required — Number of successfully imported users from the request
    - `errors` ImportUsersResponseError[], required — Contains all users that could not be imported due to an error
      - `uid` string, required
      - `invalid_birthdate` string — If this field is not null, the birthdate cannot be validated
      - `invalid_gender` string — If this field is not null, the gender cannot be validated
      - `invalid_zipcode` string — If this field is not null, the zipcode cannot be validated
      - `invalid_question` string — If this field is not null, the question was not found or there is no mapping for the given answer values
      - `unsupported_languages` boolean — If this field is true, the user was ignored because it did not have any supported languages.
      - `invalid_answer_format` ImportUsersResponseErrorAnswerFormat — If this field is not null, the supplied answer for the given question is invalid.
        - `question` string, required
        - `reason` string, required

---

[API](https://skmtc.net/bitlabs/apis/bitlabs-client-api.md) · [All operations](https://skmtc.net/bitlabs/apis/bitlabs-client-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bitlabs/bitlabs-client-api/revisions/99209a6285bf/schema)