Relay.app Docs
  • Getting Started
    • Introduction
    • Helpful Resources
    • FAQ
  • Triggers
    • Triggers 101
    • Webhook Trigger
    • Mailhook Trigger
    • Manual Trigger
    • Scheduled Trigger
    • Batch Triggers
    • RSS Trigger
  • Actions in Apps
    • Actions 101
  • DATA
    • Step Outputs
    • Find Steps
    • Lists (Arrays)
    • Inspecting Run Data
  • AI
    • AI Steps
    • Human-in-the-Loop AI reviews
    • AI Credits
    • Agentic Tool Use
    • Knowledge
    • Prompt Templates
    • Prompt Tips
    • Audio Transcription
  • Built-in actions
    • Transform data
    • Search Google
    • Scrape Text from Website
    • Custom HTTP Requests
    • Run Custom Code (JS)
  • Flow Control
    • Paths
    • Iterators
    • Wait steps
    • Sequences
  • Human-in-the-Loop
    • Human-in-the-Loop Steps
    • AI output reviews
    • Roles
  • Workflows
    • Folders and Organization
    • Sharing Workflows
    • Headings
    • Notes
  • TEMPLATES
    • About Workflow Templates
    • Using a Template (Importing)
    • Creating a Template (Exporting)
  • Workspace
    • Step & AI credit usage
    • Billing and Plans
    • Workspace administration
    • (Sharing) App Accounts
  • App-Specific FAQs
    • Airtable
    • Attio
    • Cal.com
    • Coda
    • DeepSeek
    • Discord
    • Fireflies
    • Gmail
    • Google Docs
    • Google Drive
    • Google Sheets
    • Microsoft Permissions
    • Microsoft Outlook Mail
    • Notion
    • OpenAI
    • OpenPhone
    • Slack
    • X (Twitter)
    • QuickBooks Online
Powered by GitBook
On this page
  • When to use Sequences
  • Basics
  • Creating a Sequence
  • Setting up a Sequence
  • Using a Sequence
  • Reusing a Sequence
  • Exporting and sharing Sequences
  • Exporting a Sequence
  • Using an exported Sequence
  • Seeing what workflows use an exported Sequence
  • Publishing changes to an exported Sequence
  • Manually upgrading an imported Sequence to the latest version
  • FAQ

Was this helpful?

  1. Flow Control

Sequences

Last updated 1 month ago

Was this helpful?

Sequences are an advanced feature. Make sure you're building workflows first.

Sequences are sub-workflows that you can reuse within one workflow or even across multiple workflows once you them.

When to use Sequences

You might use Sequences when you need to perform the same set of actions multiple times. Adding these actions to a Sequence will have a number of benefits:

  • The Sequence configuration will function as a "template" – this means that changes that are made to the Sequence will be applied everywhere the Sequence is invoked.

  • Complex workflows become more readable by collapsing multiple steps into a sequence. This will improve maintainability over the long-term

  • Sequences can be so that they can be used by yourself or other members in your team in other workflows than the one it was created in.

Example: If you repeatedly need to look up contact/customer information across multiple tools like a CRM, Notion and LinkedIn, a dedicated Sequence will let you "build once, use everywhere".

Basics

Creating a Sequence

You can create a new Sequence by clicking 'Create new Sequence' from the Sequences menu.

Setting up a Sequence

In the example below, we'll create a Sequence that

  • Looks up the LinkedIn profile of a person by their name and email address

  • Summarizes the LinkedIn profile via AI

  • Sends the AI-generated summary over Slack to a specific channel

Configuring Sequence Inputs

Start by giving the Sequence a name ('Summarize LI profile over Slack' in our example case) and define the Sequence inputs.

Sequence inputs may be defined as primary data types like "Text", "Date" or "Email address" or as App Objects. In our example, we'll want a Slack Channel object as the input.

Adding Steps to the Sequence

Next, build out your Sequence as if it's a regular workflow

Configuring Sequence Outputs

Finally, you may specify what data the Sequence should return to the workflow that invoked it. This is optional - in certain cases you don't need data back from the Sequence (but often you do).

In our example, we will want to return two things:

  • The URL of the LinkedIn profile

  • The AI-generated Summary of the profile (that was also already sent over Slack)

Using a Sequence

Invoking a Sequence

After clicking 'Back to workflow' for a newly created Sequence, the Sequence is already added as a step in your workflow.

After clicking on the Step, you can specify all inputs and can see which outputs will be available after the Sequence has ran.

Using Sequence output data

Reusing a Sequence

  • Sequences created inside this workflow

  • Sequences created by you that you exported

  • Sequences created by others that they exported

Exporting and sharing Sequences

Exporting a Sequence if you wan to reuse it across other workflows, or if you want other people in your workspace to use it in their own workflows

Exporting a Sequence

Once a Sequence doesn't have any configuration errors or leftovers, it can be exported. To export a sequence, click the 'Export to workspace' button in its header.

Click 'Export' to export the workflow.

Using an exported Sequence

Afterwards, it's literally filling out the same Sequence inputs.

Imported Sequences are read-only

Note that this will only work if you have Edit permissions to the original Sequence.

When using a Sequence that's created and exported by someone else on your team, you'll need to explicitly add them as a workflow collaborator in order to use their app connections that are used in this Workflow.

Seeing what workflows use an exported Sequence

Publishing changes to an exported Sequence

Once an exported Sequence is edited, changes will need to be published. Once published, all workflows that use this Sequence may apply the changes to the Sequence (or in rare cases you may want to keep them on the previous version of the Sequence)

After clicking 'Publish', you'll see an overview of all the workflows that use this Sequence. Here you can select all workflows that should be auto-upgraded with the Sequence changes.

Manually upgrading an imported Sequence to the latest version

To preview the new (changed) version of the Sequence before applying them in your workflow, click the [...] overflow in the banner, followed by 'Preview'.

FAQ

Can I create a Sequence out of existing steps?

Not yet. If there are existing steps you want to "refactor" into a Sequence, you'll need to recreate them in the Sequence. We plan to support creating Sequences out of existing steps in the future, though.

Can I move steps into a Sequence?

Not yet. If there are existing steps you want to move into a Sequence, you'll need to recreate them in the Sequence. We plan to support moving steps into Sequences in the future, though.

Can I share a Sequence with someone externally (outside of my workspace)?
Can I make a copy of a Sequence exported by someone else?

Yes! You can duplicate any Sequence that you have 'view' permissions via the overflow menu.

Click on 'Sequence output' to invoke the panel where you can configure the output. It's possible to output entire , and/or specific data fields. In our case, we're going to return the entire Step Output of the AI step, and specifically just the LinkedIn profile URL from the Step Output of the Profile data.

Using the output of Sequences is exactly the same as using data from regular . In our example, we're adding the 'LinkedIn URL' that was returned by the Sequence in a step to create/update a contact in HubSpot.

If you're looking to use an existing Sequence, you need to go to the 'Sequences' submenu in the Step menu. In addition to the '' action, you'll find sections with

Learn more about .

Next, confirm the name of the Sequence and optionally add it to a . By default, the folder will be selected that its original parent workflow is in.

Sharing/permission-wise, exported Sequences act like regular workflows: will be inherited from the folder where they're in and/but can also be set at the Sequence level.

Using an exported Sequence is very similar to using a Sequence that you . The key difference is that you'll need to explicitly select it from the 'Sequences' menu.

For our example, we're going to reuse the 'Summarize LI profile over Slack' Sequence that we created .

Imported Sequences cannot be edited directly from the workflows where they're used. To make changes to a Sequence that you imported, click 'View sequence' followed by 'Edit original'. Once changes are made to a Sequence that's exported, they will need to be to workflows that use it before they go into effect.

Sequences that are created by someone else will use other people's app connections in their steps. If you want the steps inside such a Sequence to use your own app connections instead, you can and use that instead.

When looking at an exported Sequence, the 'View usage' button in its header will open a side panel that shows a list of all workflows that use this Sequence, and what they're using.

Note: only workflows without any pending changes can be auto-upgraded. When there are other pending changes or you chose to unselect a workflow, you'll need to in these workflows.

When changes to an exported Sequence weren't to the one or more workflows it is used in, the Sequence step in these workflows will have a banner that will let you either 'Upgrade' to the latest version of the Sequence, or 'Dismiss' this update and stay on the old/current version.

You can now from Sequences, just like you can for Workflows!

Step Outputs
Step Outputs
permissions
create templates
Create new Sequence
using exported sequences here
just created
earlier
published
make a copy of the Sequence
version
manually apply the changes
published
comfortable
export
exported
folder
Create a new Seqence by clicking 'Create new Sequence' in the 'Sequences' menu
Specify what data your Sequence needs in the Sequence Input
Example Sequence
Configure the Sequence output by specifying what data should be returned to the workflow that invokes it
Configuring a Sequence step
Using Sequence outputs is like using regular Step Outputs
The Sequence menu showing various Sequences
To export a Sequence, click 'Export to workspace'
To export a Sequence, give it a name and specify the destination folder
Exported Sequences are shown in the Sequence menu
Configuring an imported Sequence
Read-only view of an imported Sequence
To publish changes to an exported Sequence, click 'Publish'
Changes made to an exported workflow can be auto-applied to workflows that use it
Manually upgrade a Sequence to the latest version by clicking 'Upgrade'
Preview a changed Sequence by clicking 'Preview'