---
title: "Add User and folder"
method: POST
path: "/users/add_user_and_folder"
tags: ["User Management"]
---

# Add User and folder

`POST /users/add_user_and_folder`

## Request

- Base URL: `https://api.synup.com/api/v4`
- URL: `https://api.synup.com/api/v4/users/add_user_and_folder`
- Auth: none required
- TypeScript: <https://skmtc.dev/synup/apis/synup-api/docs/users/add_user_and_folder/post.ts> (a function with typed inputs; its response is checked against the schema)

This api is a combination of add_user and create_folder and assign_folder_to_user APIs. The API will take in all parameters of add_user API and create_folder APIs. Operations to be done are create user, create folder and assign folder to user.

## Headers

- `Authorization` string

## Request body

- object
  - `input` object, required
    - `roleId` string, required
    - `firstName` string, required
    - `lastName` string, required
    - `email` string, required
    - `directCustomer` boolean, required
    - `locale` string, required
    - `locationIds` string[], required
    - `socialProfileIds` string[], required
    - `name` string, required
    - `userId` string, required: Base64 encoded user ID
    - `isDefaultFolder` boolean, required

## Response `200`

Successfully added folders to user

- object
  - `data` object, required
    - `addUserAndFolder` object, required
      - `success` boolean, required
      - `assignFolder` boolean, required
      - `user` object, required
        - `firstName` string, required
        - `lastName` string, required
        - `email` string, required
        - `directCustomer` boolean, required
        - `databaseId` integer, required
      - `folder` object, required
        - `id` string, required
        - `name` string, required
        - `locationCount` unknown, required
      - `errors` string[], required
    - `addFoldersForUser` object
      - `status` object[]
        - `errors` string[], nullable
        - `folderId` string, uuid
        - `success` boolean

---

[API](https://skmtc.dev/synup/apis/synup-api.md) - [All operations](https://skmtc.dev/synup/apis/synup-api/llms.txt) - [OpenAPI document](https://skmtc.dev/synup/apis/synup-api/revisions/67de2d51c22e?raw)