Creating a Connection
The following GET will return a target URL. Use this URL to log in to the Dropbox for Business account to authenticate and create the connection. Make sure you connect using an Administrator account.
GET {{url}}v1/connections/platforms/dfb/new
Creating a Connection Using Custom Credentials
Create a new connection using custom credentials with the example call below. Replace the name, client_id, and client_secret with information relevant to your connection.
POST {{url}}v1/connections/ |
|---|
{
"name": "Dropbox for Business",
"platform": {
"id": "dfb"
},
"auth": {
"client_id": "{{clientID}}",
"client_secret": "{{clientSecret}}"
}
}
|
Creating a Connection with Single Sign-On (SSO)
Create a new connection using single sign-on with the example call below. You will need to obtain the applicable access token for your Dropbox for Business account.
POST {{url}}v1/connections/ |
|---|
{
"name": "Dropbox for Business",
"platform": {
"id": "dfb"
},
"auth": {
"access_token": "{{access_token}}"
}
}
|
Creating a Job
Create a simple transfer job using the example call below. Replace the information with information relevant to your job and connectors.
The following are known issues when creating a job for a Dropbox for Business account using an Administrator account connection.
Connection-based Impersonation should be used due to a caching issue which may incorrect shared folder detection
Connection-based Impersonation is shown in the user-interface as "Run As...." option on the Locations step when creating a new job
Path-based impersonation should not be used, first 'folder' is a user name such as "path": "/user@company.com/"
{
"name":"Simple Job",
"kind": "transfer",
"transfer": {
"transfer_type": "copy",
"source": {
"connection": { "id": "{{DropboxForBusiness_Admin_ConnectionID}}" },
"impersonate_as": { "email": "user@company.com" },
"target": {
"path": "/sourceFolder"
}
},
"destination": {
"connection": { "id": "{{OneDriveForBusiness_connection_destinationID}}" },
"target": {
"path": "/Documents/destinationFolder"
}
},
"simulation_mode": false
},
"schedule": {
"mode": "manual"
},
"stop_policy": {
"on_success": 5,
"on_failure": 5,
"on_execute": 25
},
"category": {
"name": "Report Category {Name}"
}
}