Dropbox offers secure file sharing and storage. It helps users manage sharing capabilities with groups and external collaborators through central folders with granular permissions.

To configure the connector, following parameters are required:

• Connector name

• API key (access token) for the cloud account

• Instance DateTime Offset (refer Configuring additional datetime offset in connectors for more details).

Supported objects and operations

Users

Table 55: Supported operations for Users

Operation	VERB
Create	POST
Update	PUT
Delete	DELETE
Get all users	GET
Get user by Id	GET
Get users with pagination	GET

Groups

Table 56: Supported operations for Groups

Operation	VERB
Create	POST
Update	PUT
Delete	DELETE
Get all groups	GET
Get group by Id	GET
Get groups with pagination	GET

Roles

Table 57: Supported operations for Roles

Operation	VERB
Get all roles	GET
Get role by Id	GET

Mandatory fields

Users

• emails.value

Groups

• displayName

User and Group mapping

The user and group mappings are listed in the tables below.

Table 58: User mapping

SCIM parameter	Dropbox parameter
id	profile.team_member_id
externalId	profile.external_id
userName	profile.email
name.familyName	profile.name.surname
name.givenName	profile.name.given_name
name.formatted	profile.name.display_name
displayName	profile.name.display_name
emails[0].value	profile.email
active	profile.status[".tag"]
groups	profile.groups
roles	role[".tag"]
meta.created	profile.joined_on

 

Table 59: Group mapping

SCIM parameter	Dropbox parameter
id	group_id
displayName	group_name
members[].value	members[].profile.team_member_id
members[].display	members[].profile.name.display_name
enterpriseExtension.externalId	group_external_id
meta.created	created

Connector limitations

• The LastModified date is not applicable for Groups.

• Both created and lastModified dates are not applicable for Users.

• Invalid Target URL returns the below mentioned status code and error message.

  • Status code: 500
  • Error message: There was an issue processing this request error.

• User's role cannot be updated.

• The user cannot be set as active while performing create or update.

• The information about groups will not be present in the Create user response.

• The Dropbox user statuses active and invited are considered as active in the connector.

• APIs are not available to retrieve roles from Dropbox. Hence, the endpoints of the connector's roles provide predefined set of roles.

• Deleted members cannot be added to a group. In a request to add multiple members to a group, if any user is deleted (members_not_in_team), then the entire request is not carried out.

• The userName property for user is read-only. However, this can be updated by updating the emails → value. The emails → value has been mapped against userName.

• Dropbox returns error 500 without any message being shown, on cursor pagination with cursor length equal to 1. The same is observed when trying to update a deleted group. In this case, the connector returns the following error code and message:

  • Error Code: 400
  • Error message: Error occurred.