---
title: "Create pending users"
method: POST
path: "/users/v1/pending-users"
tags: ["Users:v1:Pending Request Users"]
---

# Create pending users

`POST /users/v1/pending-users`

Create request to new users that will appear to admin in pending approval.

## Request body

- PendingUsersRequest
  - `users` PendingUserRequest[], required — list of pending users
    - `firstName` string, required — The user's first name
    - `lastName` string, required — The user's last name
    - `phoneNumber` string — The user's phone number
    - `email` string — The user's email (mandatory for managers and owners)
    - `customFields` BaseCustomField[] — The user's custom fields
      - `customFieldId` integer, required — The custom field unique id
      - `value` unknown, required
    - `rawFields` object — The user's raw fields
    - `linkId` integer — The id of the invite link
    - `source` string — The source of the user
    - `userId` integer — Connecteam user id of the user
    - `suggestedUserId` integer — Connecteam user id of the user for the admin to match
    - `sourceIcon` string — The icon of the external system if users come from integration
    - `externalUserId` string — The user ID from external system
    - `integrationId` integer — The integration ID from the integration service
    - `extraFields` object — Extra fields from integration
    - `profilePictureFileId` string — The file ID obtained from the upload attachment endpoint (POST /attachments/v1/files/generate-upload-url) with featureType set to 'users'. The file must be finalized via the complete-upload endpoint before use.

## Response `200`

Successful Response

- APIResponsePendingUsersResponse
  - `requestId` string
  - `data` PendingUsersResponse, required — Response model for creating user pending requests.
    - `ids` integer[], required — new pending users

## Other responses

- `422` — Validation Error

---

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