---
title: "Add folders to user"
method: POST
path: "/users/folders/add"
tags: ["User Management"]
---

# Add folders to user

`POST /users/folders/add`

## Request

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

This API associates one or more folders with a specified user, granting them access to manage those folders.

**Behavior:**
- Supports assigning multiple folders to a single user.
- Updates the user's permissions based on assigned folders.

## Headers

- `Authorization` string

## Request body

- object
  - `input` object
    - `userId` string, required: Base64 encoded user ID
    - `folderIds` string[], required: Array of folder UUIDs to associate with the user
    - `defaultFolderId` string, required

## Response `200`

Successfully added folders to user

- object
  - `data` object
    - `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)