Dropbox Directory Modified

The Dropbox Directory Modified trigger monitors activity on a Dropbox folder, and sends JSON messages about that activity, which can include adding, changing, and deleting files.

The Dropbox Directory Modified trigger has two output ports. The success port (✔) can send a message if the trigger polls successfully. The failure port (x) can send a message if the trigger fails to poll.

Configuring Your Dropbox Account App

Before creating a Dropbox Directory Modified trigger on a Dropbox account, you must configure the account with an app and generate an OAuth2 access token for it.

  1. Login to your Dropbox account and navigate to https://www.dropbox.com/developers/apps.
  2. On the My apps page, click Create app.
  3. On the Create a new app on the Dropbox Platform page:
    1. Choose an API: Select Dropbox API.
    2. Choose the type of access you need: Select Full Dropbox.
    3. Name your app: Provide a name for your app.
    4. Review the Dropbox API Terms and Conditions and check the box.
    5. Click Create app.
  4. A page opens for your app on the Settings tab.
    1. Under OAuth2 > Generated access token, click Generate.
    2. Copy the generated token.

Parameters

Note: See also Working with Parameters in Automations Workflows.

Tip: To test that your parameters work as expected, click Validate.

  • Access Token: Provide the OAuth2 access token for the Dropbox account you want to watch. For more information, see Dropbox Directory Modified (above).
  • Path to Watch: Provide a location on your Dropbox account to watch for changes, using forward slashes. For example: /MyFolder. To specify the top-level, or 'root', use a single forward slash: /.
  • Watch Subdirectories: To watch activity in the selected directory and all subdirectories, specify Yes. To watch activity only in the selected directory and not in its subdirectories, specify No.
  • Filter: By default, all actions on the specified directory are monitored, including adding (CREATE), changing (MODIFY), and deleting (DELETE) files (and folders, if applicable). To monitor only one or two of these actions, click the "x" beside the action you do not want to monitor to remove it. To add an action after removing it, click inside the dropbox and select it.

Output Keys

See Also

Key Description
time Event time
source Event type
error.type (Failure port only) Error type
error.message (Failure port only) Error message
file.event (Success port only) File action (Create/Modify/Delete)
file.path (Success port only) File path
file.rootName

(Success port only) File root name
dropbox.user (Success port only) Dropbox account