Actions are reusable code steps that integrate your apps, data and APIs. For example, you can send HTTP requests to an external service using the HTTP action, or use actions to send data to Slack, Amazon S3, and more. You can use thousands of actions across 100+ apps today.
Typically, integrating with these services requires a lot of code to manage connection logic, error handling, etc. Actions handle that for you. You only need to specify the parameters required for the Action — for example, for the HTTP action, what data you want to send and the URL you want to send it to.
You can also create your own actions that can be shared across your own workflows, or published to all Pipedream users.
# Using Existing Actions
Actions are executed in the order they appear in your workflow.
Action return values and exports may be referenced in later steps via the
You can add multiple Actions within a single workflow (for example to send data to multiple S3 buckets and an HTTP endpoint). Actions can be added at any point in your workflow.
Let's use the Send HTTP Request action to send an HTTP request from a workflow. First, add a new Action to your workflow by clicking on the + button between any two steps.
Choose the Send HTTP Request action:
This action has one required parameter: the URL where you want to send the HTTP request.
This action defaults to sending an HTTP
POST request. If you'd like to change the HTTP method, add an HTTP payload, query string parameters or headers, you can click the add individual property field above the form fields and select the appropriate parameter:
# Creating your own actions
You can author and publish your own actions at https://pipedream.com/actions, accessible from the Actions link in the header.
This video describes how to create an action end-to-end, including how to pass params to that action, how to associate actions with apps, and more:
For example, let's say I wanted to publish my own Send a Slack Message action, using Slack's
@slack/web-api npm package instead of the HTTP API.
I'd go to the Action header, click New, and start writing code:
Actions have a title, a default step name, a description, and code.
Actions are just code steps: you can write any Node.js code, connect apps, define params, and more. Unlike normal code steps, actions can be used across workflows and shared with other users. This reusability is powerful, and others benefit in huge ways from the actions you share.
# Save vs. Publish
Saving an action makes the action available within any workflow in your account. Saving does not make the action available to anyone else.
When you press the Publish button, this makes the action available to everyone.
# How actions are associated with apps
If you've linked one or more apps (click the + sign to the left of the code), the action will be associated with that app, so when you search for the action when adding a new step, it'll show up under Github, Slack, etc.
Otherwise, if you haven't linked an app to the action, it'll show up under the Non-app actions:
Actions are versioned: each time you publish a change, it increments the minor version number (actions have semantic versions of the form
For example, publishing an action for the first time cuts a
0.1 version of that action. All users will have access to verison
0.1 of your action.
If you want to make a change, you can edit and save your action, and those changes will be available only to your account. Once you're ready to ship the new version, click Publish again. Now,
- Any workflows that are using version
0.1of the action will continue using that version.
- Any time a user searches for your action in a new step, they'll see the most recent version of the action (
You can change the version in any manner you'd like before publishing that new version. For example, you can increment the major version of the action if you're introducing a breaking change.
Action code cannot reference environment variables (for example, using
process.env). Since actions can be used by anyone, it's not guaranteed that a user would have a specific variable set in their environment. Therefore, actions that use environment variables are unlikely to work for someone else.
Instead, write your action to accept inputs via step params.