Team Folder Create

POST

https://api.dropboxapi.com/2/team/team_folder/create

Creates a new, active, team folder with no members. This endpoint can only be used for teams that do not already have a shared team space.

Permission : Team member file access.

Required scope: team_data.content.write

Endpoint format: RPC

Authentication: Team

Creates a new, active, team folder with no members. This endpoint can only be used for teams that do not already have a shared team space. Permission : Team member file access. **Required scope:** `team_data.content.write` **Endpoint format:** [RPC](https://docs.dropboxapi.com/dropbox-api/docs/technical-reference/request-response-formats#rpc-endpoints) **Authentication:** [Team](https://docs.dropboxapi.com/dropbox-api/docs/auth-types#team-authentication)

Authentication

AuthorizationBearer

Team-level OAuth 2.0 token issued to a Dropbox Business admin. Use Authorization: Bearer <token>.

Obtain via the authorization code flow with team-scoped permissions.

Grants access to team-wide administrative operations.

You can generate a short-lived access token from the App Console; see Testing with a generated token.

Team-level OAuth 2.0 token issued to a Dropbox Business admin. Use `Authorization: Bearer <token>`. Obtain via the authorization code flow with team-scoped permissions. Grants access to team-wide administrative operations. You can generate a short-lived access token from the App Console; see [Testing with a generated token](https://docs.dropboxapi.com/dropbox-api/docs/oauth#testing-with-a-generated-token).

Request

This endpoint expects an object.

namestringRequired

Name for the new team folder.

sync_settingobject or nullOptional

The sync setting to apply to this team folder. Only permitted if the team has team selective sync enabled.

Response headers

X-Dropbox-Request-IdstringOptional

A unique identifier for the request, useful for debugging and support.

Response

Successful response

content_sync_settingslist of objects

Sync settings applied to contents of this team folder.

is_team_shared_dropboxboolean

True if this team folder is a shared team root.

namestring

The name of the team folder.

statusobject

The status of the team folder.

sync_settingobject

The sync setting applied to this team folder.

team_folder_idany

The ID of the team folder.

quota_limitlongOptional

The quota limit in bytes for this team folder namespace tree.

Errors

401

Unauthorized Error

403

Forbidden Error

409

Conflict Error

429

Too Many Requests Error

500

Internal Server Error