---
title: "Add Guest To Folder"
method: POST
path: "/v2/folder/{folder_id}/guest/{guest_id}"
tags: ["Guests"]
---

# Add Guest To Folder

`POST /v2/folder/{folder_id}/guest/{guest_id}`

Share a Folder with a guest. \
 \
***Note:** This endpoint is only available to Workspaces on our [Enterprise Plan](https://clickup.com/pricing).*

## Path parameters

- `folder_id` number, required
- `guest_id` number, required

## Query parameters

- `include_shared` boolean

## Request body

- object
  - `permission_level` string, required — Can be `read` (view only), `comment`, `edit`, or `create` (full).

## Response `200`

- object
  - `guest` object, required
    - `user` User, required — unresolved $ref
    - `invited_by` InvitedBy, required — unresolved $ref
    - `can_see_time_spent` boolean, required
    - `can_see_time_estimated` boolean, required
    - `can_edit_tags` boolean, required
    - `shared` object, required
      - `tasks` string[], required
      - `lists` string[], required
      - `folders` object[], required
        - `id` string, required
        - `name` string, required
        - `orderindex` integer, required
        - `override_statuses` boolean, required
        - `hidden` boolean, required
        - `task_count` string, required
        - `archived` boolean, required
        - `statuses` Status[], required — unresolved $ref
        - `lists` string[], required
        - `permission_level` string, required

---

[API](https://skmtc.dev/clickup/apis/clickup-api-v2-reference.md) · [All operations](https://skmtc.dev/clickup/apis/clickup-api-v2-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/clickup/clickup-api-v2-reference/revisions/72216f55b952/schema)