Create/Update a Share Link with Dropbox API on New Requests from HTTP / Webhook API

Pipedream makes it easy to connect APIs for Dropbox, HTTP / Webhook and 1,600+ other apps remarkably fast.

Trigger workflow on

New Requests from the HTTP / Webhook API

Next, do this

Create/Update a Share Link with the Dropbox API

No credit card required

▶

Watch us build a workflow

7 min

Watch now ➜

Trusted by 750,000+ developers from startups to Fortune 500 companies

Developers ♥ Pipedream

Getting Started#

This integration creates a workflow with a HTTP / Webhook trigger and Dropbox action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the New Requests trigger
1. Optional- Configure Body Only
2. Optional- Configure Response Status Code
3. Optional- Configure Response Content-Type
4. Optional- Configure Response Body
5. Connect your HTTP / Webhook account
Configure the Create/Update a Share Link action
1. Connect your Dropbox account
2. Select a Path
3. Configure Require password
4. Optional- Configure Link password
5. Configure Allow downloads
6. Optional- Configure Expires
7. Optional- Select a Audience
8. Optional- Select a Access
Deploy the workflow
Send a test event to validate your setup
Turn on the trigger

Details#

This integration uses pre-built, source-available components from Pipedream's GitHub repo. These components are developed by Pipedream and the community, and verified and maintained by Pipedream.

To contribute an update to an existing component or create a new component, create a PR on GitHub. If you're new to Pipedream component development, you can start with quickstarts for trigger span and action development, and then review the component API reference.

Trigger#

New Requests on HTTP / Webhook

Description:Get a URL and emit the full HTTP event on every request (including headers and query parameters). You can also configure the HTTP response code, body, and more.

Version:0.1.1

Key:http-new-requests

View on GitHub

Trigger Code#

import http from "../../http.app.mjs";

// Core HTTP component
export default {
  key: "http-new-requests",
  name: "New Requests",
  description: "Get a URL and emit the full HTTP event on every request (including headers and query parameters). You can also configure the HTTP response code, body, and more.",
  version: "0.1.1",
  type: "source",
  props: {
    httpInterface: {
      type: "$.interface.http",
      customResponse: true,
    },
    emitBodyOnly: {
      type: "boolean",
      label: "Body Only",
      description: "This source emits an event representing the full HTTP request by default. Select `true` to emit the body only.",
      optional: true,
      default: false,
    },
    resStatusCode: {
      type: "string",
      label: "Response Status Code",
      description: "The status code to return in the HTTP response",
      optional: true,
      default: "200",
    },
    resContentType: {
      type: "string",
      label: "Response Content-Type",
      description: "The `Content-Type` of the body returned in the HTTP response",
      optional: true,
      default: "application/json",
    },
    resBody: {
      type: "string",
      label: "Response Body",
      description: "The body to return in the HTTP response",
      optional: true,
      default: "{ \"success\": true }",
    },
    http,
  },
  async run(event) {
    const summary = `${event.method} ${event.path}`;

    this.httpInterface.respond({
      status: this.resStatusCode,
      body: this.resBody,
      headers: {
        "content-type": this.resContentType,
      },
    });

    if (this.emitBodyOnly) {
      this.$emit(event.body, {
        summary,
      });
    } else {
      this.$emit(event, {
        summary,
      });
    }
  },
};

Trigger Configuration#

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI and CLI.

Label	Prop	Type	Description
N/A	`httpInterface`	`$.interface.http`	This component uses `$.interface.http` to generate a unique URL when the component is first instantiated. Each request to the URL will trigger the `run()` method of the component.
Body Only	`emitBodyOnly`	`boolean`	This source emits an event representing the full HTTP request by default. Select `true` to emit the body only.
Response Status Code	`resStatusCode`	`string`	The status code to return in the HTTP response
Response Content-Type	`resContentType`	`string`	The `Content-Type` of the body returned in the HTTP response
Response Body	`resBody`	`string`	The body to return in the HTTP response
HTTP / Webhook	`http`	`app`	This component uses the HTTP / Webhook app.

Trigger Authentication#

The HTTP / Webhook API does not require authentication.

About HTTP / Webhook#

Get a unique URL where you can send HTTP or webhook requests

Action#

Create/Update a Share Link on Dropbox

Description:Creates or updates a public share link to the file or folder (It allows to share the file or folder with anyone). [See docs here](https://dropbox.github.io/dropbox-sdk-js/Dropbox.html#sharingCreateSharedLinkWithSettings__anchor)

Version:0.0.7

Key:dropbox-create-update-share-link

View on GitHub

Dropbox Overview#

With the Dropbox API, you can build a variety of applications that range from
simple file sharing to complex content management systems. Some examples of
what you can build using the Dropbox API include:

A file sharing application that allows users to share and sync files across
devices
A content management system that allows users to manage and share files and
folders
A note taking application that allows users to sync notes across devices
A task management application that allows users to manage and share tasks and
files
A document management application that allows users to manage and share
documents and files

Action Code#

import dropbox from "../../dropbox.app.mjs";
import consts from "../../common/consts.mjs";

export default {
  name: "Create/Update a Share Link",
  description: "Creates or updates a public share link to the file or folder (It allows to share the file or folder with anyone). [See docs here](https://dropbox.github.io/dropbox-sdk-js/Dropbox.html#sharingCreateSharedLinkWithSettings__anchor)",
  key: "dropbox-create-update-share-link",
  version: "0.0.7",
  type: "action",
  props: {
    dropbox,
    path: {
      propDefinition: [
        dropbox,
        "pathFileFolder",
        () => ({
          omitRootFolder: true,
        }),
      ],
      description: "The path to be shared by the shared link.",
    },
    requirePassword: {
      type: "boolean",
      label: "Require password",
      description: "Boolean flag to enable or disable password protection.",
      default: false,
    },
    linkPassword: {
      type: "string",
      label: "Link password",
      description: "If `require_password` is `true`, this is needed to specify the password to access the link.",
      optional: true,
    },
    allowDownload: {
      type: "boolean",
      label: "Allow downloads",
      description: "Boolean flag to allow or not allow capabilities for shared links.",
    },
    expires: {
      type: "string",
      label: "Expires",
      description: "Expiration time of the shared link. By default the link never expires. Make sure to use a valid [timestamp](https://dropbox.github.io/dropbox-sdk-js/global.html#Timestamp) value.",
      optional: true,
    },
    audience: {
      type: "string",
      label: "Audience",
      description: "The new audience who can benefit from the access level specified by the link's access level specified in the `link_access_level` field of `LinkPermissions`. This is used in conjunction with team policies and shared folder policies to determine the final effective audience type in the `effective_audience` field of `LinkPermissions.",
      optional: true,
      options: consts.CREATE_SHARED_LINK_AUDIENCE_OPTIONS,
    },
    access: {
      type: "string",
      label: "Access",
      description: "Requested access level you want the audience to gain from this link. Note, modifying access level for an existing link is not supported.",
      optional: true,
      options: consts.CREATE_SHARED_LINK_ACCESS_OPTIONS,
    },
  },
  async run({ $ }) {
    const {
      path,
      requirePassword,
      linkPassword,
      expires,
      audience,
      access,
      requestedVisibility,
      allowDownload,
      removeExpiration,
    } = this;

    if (requirePassword && !linkPassword) {
      throw new Error("Since the password is required, please add a linkPassword");
    }

    const res = await this.dropbox.createSharedLink({
      path: this.dropbox.getPath(path),
      settings: {
        require_password: requirePassword,
        link_password: linkPassword,
        expires,
        audience,
        access,
        requested_visibility: requestedVisibility,
        allow_download: allowDownload,
      },
      remove_expiration: removeExpiration,
    });
    $.export("$summary", `Shared link for "${path?.label || path}" successfully created`);
    return res;
  },
};

Action Configuration#

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI.

Label	Prop	Type	Description
Dropbox	`dropbox`	`app`	This component uses the Dropbox app.
Path	`path`	`string`	Select a value from the drop down menu.
Require password	`requirePassword`	`boolean`	Boolean flag to enable or disable password protection.
Link password	`linkPassword`	`string`	If `require_password` is `true`, this is needed to specify the password to access the link.
Allow downloads	`allowDownload`	`boolean`	Boolean flag to allow or not allow capabilities for shared links.
Expires	`expires`	`string`	Expiration time of the shared link. By default the link never expires. Make sure to use a valid timestamp value.
Audience	`audience`	`string`	Select a value from the drop down menu:`publicteamno_onepasswordmembersother`
Access	`access`	`string`	Select a value from the drop down menu:`viewereditormaxother`

Action Authentication#

Dropbox uses OAuth authentication. When you connect your Dropbox account, Pipedream will open a popup window where you can sign into Dropbox and grant Pipedream permission to connect to your account. Pipedream securely stores and automatically refreshes the OAuth tokens so you can easily authenticate any Dropbox API.

Pipedream requests the following authorization scopes when you connect your account:

About Dropbox#

Dropbox gives you secure access to all your files. Collaborate with friends, family, and coworkers from any device.

More Ways to Connect Dropbox + HTTP / Webhook#

Other Popular Integrations#

Custom Request with HTTP / Webhook API on New or Modified File or Folder from Dropbox API

Dropbox + HTTP / Webhook

Create/Update a Share Link with Dropbox API on New Requests from HTTP / Webhook API

Pipedream makes it easy to connect APIs for Dropbox, HTTP / Webhook and 1,600+ other apps remarkably fast.

Trusted by 750,000+ developers from startups to Fortune 500 companies

Developers ♥ Pipedream

1-12of1,600+apps by most popular

1
-
12
of
1,600+
apps by most popular