Creating Workflows

You can create a Workflow from a one-click template or build it from scratch. Templates are the fastest way to start, and you can change any step after you pick one.

A Workflow starts with one trigger. After the trigger, you can add logic to filter or branch, and one or more actions. If you're new to triggers, logic and actions, start with Getting Started with Workflows. This article covers creating a Workflow, connecting your email provider, and building Workflows with AI.

🛠️ Early Access

Workflows is in Early Access. To request access, fill out the Workflows Interest Form. We're actively building it, so its features and limitations may change without advance notice.


Creating a Workflow from a template

  1. Open up the Ordergroove Admin and click Workflows in the top toolbar.
  2. Click Create Workflow and choose a template.
  3. Click Configure on each step and fill in your details, such as the order number, gift product or new date.
  4. Click Save. Before you launch the Workflow, test it. For how, see Testing a Workflow.

These templates are available. Each one has a matching recipe in the Workflows Recipe Book that explains when to use it and what each step does.

  • Milestone order gift-with-purchase — adds a free gift to a subscriber's order at the milestone you choose, and sends an email through Klaviyo or Attentive.
  • Milestone order discount — adds a discount to a subscriber's order at the milestone you choose, and sends an email through Klaviyo or Attentive.
  • Move order dates in bulk — moves the place date on a batch of upcoming orders in one run.
  • Cancel subscriptions in bulk — cancels a group of subscriptions in one run. Your cancellation emails still send.

Creating a Workflow from scratch

This example builds a gift-with-purchase Workflow that adds a free gift to a subscriber's upcoming order. It uses these steps:

  • Trigger: Recurring Order Placed
  • Action: Add Free Gift to Upcoming Order
  • Action: Send Communication (Klaviyo or Attentive)
  • (Optional) A/B Test. For how A/B tests work, see A/B testing a Workflow.

Watch a video

Step 1: Create a new Workflow

  1. Open up the Ordergroove Admin and click Workflows in the top toolbar.
  2. Click Create Workflow, then select + Start from scratch.

Step 2: Add a trigger and an optional filter

The trigger is the event the Workflow listens for. When that event happens, the Workflow runs the steps you add after it.

  1. In the Start with a trigger box, click + See more triggers.
  2. Under Order Events, select Recurring Order Placed.

To run the Workflow only for some subscriptions, such as those for a particular product, add a filter:

  1. Click Configure on the Recurring Order Placed node, then click + Add Filter.
  2. Scroll through the filters or search for one, and select Product.
  3. Under Product, add the product you want the Workflow to run for.

Step 3: Add actions

The Workflow now listens for recurring orders of the product you filtered on, but it doesn't change anything yet. That's what actions do. In this example, you'll add a free gift to the upcoming order, then email the customer about it.

  1. In the Flow Steps box at the top left, click Action.
  2. Select Apply Free Gift. Ordergroove adds the action to the canvas.
  3. To let the customer know about their gift, add an email action. Under Send Communication, choose Klaviyo, Attentive or Other / Custom, add it to the canvas, and click Configure.
  4. Click the Key field and give the action a unique key, like winback_coffee in the example below. You'll filter on this key in your email provider.

Next, connect your email provider (see below), then test and launch the Workflow. For how, see Testing a Workflow.


Connecting your email provider

An email action sends an event, tagged with the Key you set, to Klaviyo, Attentive or your own system. Your email provider then sends the message. You connect your provider to each Workflow separately.

Connecting to Klaviyo

Connecting your Workflows to Klaviyo lets you turn any Ordergroove event, like a cancellation, into a targeted email flow, using the Key you set as the trigger. For more on how Ordergroove and Klaviyo work together, see Klaviyo Integration Overview.

  1. Open the Workflow with the Klaviyo action and make a note of the Key you set. In the example above, it's winback_coffee.
  2. Click Configure on the Klaviyo node, scroll down, and click Send test event.
  3. In Klaviyo, go to Flows > Create Flow > Build your own.
  4. Set the trigger to Metric, and search for Ordergroove under Your metrics.
  5. Select Ordergroove.workflow.send_communication.
  6. Add a trigger filter where key equals the Key you set.

Connecting to Attentive

Connecting your Workflows to Attentive lets you turn any Ordergroove event, like a cancellation, into a targeted SMS or email journey, using the Key you set as the trigger.

Before you start, make sure you've set up the Attentive integration. Then connect Attentive to each Workflow:

  1. Open the Workflow with the Attentive action and make a note of the Key you set. In the example above, it's winback_coffee.
  2. In Attentive, create a Journey triggered by the custom event ordergroove.workflow.send_communication.
  3. Add a trigger filter where key equals the Key you set.
  4. Build your message. Along with the data from the action's Event payload, you can use key, workflow_name and workflow_id.

Note: Attentive matches each event to a subscriber by email address or phone number. If a customer has neither on file, the event isn't sent. Test runs of a Workflow send real events to Attentive, so test with your own customer record.

Connecting other email providers with a webhook

If your email service provider (ESP) isn't Klaviyo or Attentive, or you want Workflow events in your own system, use the Other / Custom action. Ordergroove sends each event to a URL you choose, called a webhook. You'll usually need a developer, or your platform's support team, to set up the receiving side.

Step 1: Create a webhook

  1. In the Ordergroove Admin, go to Developers > Webhooks and click Create.
  2. Enter a Webhook name and the URL your platform gave you for incoming events.
  3. Leave Events empty unless you also want this URL to receive those Ordergroove events. Workflows send straight to the webhook you pick in the next step, so they don't need any events selected.
  4. Click Save.

Step 2: Connect the webhook to your Workflow

  1. Open the Workflow with the Other / Custom action and click Configure.
  2. Under Webhook Route, select the webhook you created.
  3. Make a note of the Key you set.

Step 3: Set up your platform

Set up your platform to listen for the workflow.send_communication event and filter on events where key equals the Key you set. Each event Ordergroove sends looks like this:

{
  "id": "6f1c2a9e-3b7d-4e0a-9c55-1f2e8d4b7a10",
  "type": "workflow.send_communication",
  "key": "winback_coffee",
  "created": "2026-10-21T15:04:05.000Z",
  "data": {
    "workflow_id": "…",
    "workflow_name": "Coffee win-back",
    "execution_id": "…",
    "is_test": false,
    "subscriber": { "email": "customer@example.com", … },
    "execution_context": { … }
  }
}
  • key is the Key on your action. Use it to decide which message to send.
  • data.subscriber holds the customer's contact details.
  • data.execution_context holds the fields you chose in the action's Event payload.
  • data.is_test is true for test runs. Use it to avoid messaging real customers while you test.
  • id is unique to each event. Use it to ignore duplicates.

Note: Webhooks receive workflow.send_communication, without the ordergroove. prefix that Klaviyo and Attentive use.

Step 4: Verify and monitor

Every request includes an Ordergroove-Signature header (ts=…,sig=…) so your developer can confirm it came from Ordergroove. The signature is an HMAC-SHA256 of <ts>.<request body>, signed with the Verification key on the webhook's About tab. For a code example, see Webhooks Verification in the Developer Documentation.

To check what was sent, click Configure on the action, then View deliveries. This opens the webhook's Deliveries tab, which shows each event and how your URL responded. Your URL should respond with a 2xx status; anything else is recorded as a failed delivery.


Building Workflows with AI

You can connect an AI assistant like Claude to your browser, describe the Workflow you want in plain language, and have it build the Workflow in your Ordergroove Admin, so you don't have to drag and configure each node yourself.

  1. Install your AI tool's browser extension (for Claude, that's Claude in Chrome) and sign in.
  2. In the Ordergroove Admin, go to Workflows and open a new Workflow.
  3. Open your AI tool and describe what you want to build. For example: "When a customer cancels a coffee subscription, send a win-back email through Klaviyo with the key winback_coffee."
  4. Watch it build the Workflow, then review each node. Click Configure on any action to check its details.
  5. Run a test, then turn the Workflow on.

Note: The AI builds a draft, and nothing goes live until you turn it on. Always check the triggers and actions before you turn a Workflow on.

Let the Retention Agent build it for you

If you'd rather start from recommendations than a blank canvas, the Retention Agent analyzes your subscription data, finds where you're losing customers, and recommends interventions. It also builds the Workflow for each one, ready for you to review and turn on. The Retention Agent is in Early Access. To request access, talk to your Customer Success Manager (CSM).


Troubleshooting

I don't see Workflows in my navigation. Workflows is in Early Access. If it's turned on for your store, ask your account admin for the Workflow Admin permission. If it isn't turned on yet, fill out the Workflows Interest Form.

My Klaviyo flow didn't send. Check that the trigger filter in Klaviyo uses the exact Key you set on the action, including capitalization, and that you sent a test event from the Klaviyo node.


Next steps