# Create Collaboration

> Windows | Cross-platform

## Project compatibility

Windows | Cross-platform

## Overview

| Description | API Method | API Path |
| --- | --- | --- |
| Create a collaboration for a file or folder in Box | POST | /create_collaboration |

## Input

| Parameter | Description | Data Type |
| --- | --- | --- |
| Type | Specifies whether the collaboration is being created on a file or a folder. | options |
| File or folder | The file or folder on which the collaboration will be created. | string |
| Role details | Additional information about the role assigned to the collaborator (e.g., Editor, Viewer, Previewer). | options |
| Access type | The type of access granted to the user or group (e.g., can view, can edit). | options |
| Group ID | The ID of the group to be added as a collaborator. In the Admin Console: Users and Groups → Groups → select group → copy the trailing ID from the URL. | string |
| Email address of collaborator | The email address of the user to add as a collaborator. The user does not need to be an existing Box user. | string |
| Notify | Indicates whether an email notification should be sent to the collaborator about this action. | boolean |
| View path permission | Determines whether the collaborator can view the full path to the item in the folder hierarchy. | boolean |

## Output

| Parameter | Description | Data Type |
| --- | --- | --- |
| Collaboration | The full response payload returned for create collaboration activity | options |

:::note
* In API workflows, a single response object is returned as the output. Any required fields can be extracted directly from this object.
* In RPA workflows, some output parameters may differ, but the necessary values can still be retrieved from the response object even if they are not explicitly exposed.
:::