View as Markdown
Dropbox icon

Dropbox TRIGGER

New File

Emit new event when a new file is added to your account or a specific folder. Make sure the number of files/folders in the watched folder does not exceed 4000.
  • Trigger
  • Instant
  • OAuth
  • Webhook delivery

IMPLEMENTATION

Deploy this event source

Connect the user's Dropbox account, configure the source, and choose the webhook where your backend receives events.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const deployed = await pd.triggers.deploy({
  id: "dropbox-new-file",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    dropbox: { authProvisionId: "apn_xxxxxxx" },
    path: "Path",
    recursive: true,
  },
  webhookUrl: "https://example.com/webhooks/dropbox",
})

console.log(deployed.id)

MCP exposes on-demand actions. Event sources are deployed through the Connect SDK or API because they continue listening after the initial request.

SCHEMA

Configuration

These inputs define which events the source watches. Dynamic options are loaded from the connected account.

New File configuration
Property Type Description
path Path string
Type the folder name to search for it in the user's Dropbox.
Required Dynamic
recursive Recursive boolean
Also watch sub-directories and their contents.
Required
includeMediaInfo Include Media Info boolean
Emit media info for photos and videos (incurs an additional API call)
Required
includeLink Include Link boolean
Emit temporary download link to file (incurs an additional API call)
Required

01

Connect

Your user authorizes Dropbox through Pipedream managed auth.

02

Deploy

Your backend deploys this source with that user's own configuration.

03

Webhook delivery

Every event is sent to the HTTP endpoint you choose when you deploy the source — as it happens.

OR

On-demand retrieval

No webhook required. Your app or agent can fetch recent events from the trigger events API.

Registry key
dropbox-new-file
Version
0.0.21
App
Dropbox
Authentication
OAuth
Delivery
Instant event
Output
Events emitted by Dropbox.