In this guide we'll go through what 1-Click actions are, how to set them up, test them, and commonly asked questions. This is an overview, take a look at our Klaviyo and Attentive documentation for setup instructions.
Overview
1-Click actions are unique and secure URLs you can send to your customers through email and SMS messages. When clicked on, they will perform a specific predetermined action such as reactivating a churned subscription.
⚠️ Platform
Note: There are two ways to implement 1-Click: through your integration with Klaviyo/Attentive or through the Ordergroove API. This article only covers 1-Click through an integration; if you'd prefer to build it yourself with the API, take a look at Marketing 1-Click Actions In Emails Through API.
Available 1-Click Actions
| Action | Description | Notes |
| Cross-sell | Add items or subscriptions to an upcoming subscription order |
|
| Delay | Delay an upcoming subscription order |
|
| Reactivate | Reactivate a previously canceled subscription |
|
The Customer's Experience
1. A customer receives an email or SMS message that includes a 1-click link.
- On an email, the link can be in a button.
2. Customer clicks the link to take the action.
The customer gets redirected to a page on your website, where they see a confirmation message on the top of the page, or an error message.
- You can specify which page to redirect users to. It can be any page on your site except for pages within your authenticated accounts section.
- We recommend redirecting users to your homepage, or you can design specific landing pages to confirm one-click actions.
3. The action takes effect immediately.
- Additional clicks will fail with a visible error.
Here's an example of a customer upsell experience:
Set up 1-Click Actions
There are three main steps; for specifics, take a look at our Klaviyo and Attentive documentation.
- Confirm the landing page on your site is set up properly.
- Build your desired 1-click URLs.
- Add the URLs to intended Klaviyo flows and/or Attentive journeys.
Testing
Before going live, we recommend testing your 1-click actions to confirm they work as expected.
Test 1-Click Reactivate
The easiest action to test is 1-click reactivate. Use a test subscription customer you have and cancel any active subscriptions they have in Ordergroove.
- In Klaviyo, go to Metrics and select ordergroove.susbcription.cancel. Click activity feed.
- Find the test customer you canceled a subscription for, and click the dropdown to show more details.
- Copy the full action_token that’s included in the customer’s details.
- Take your reactive URL and manually paste the action token: replace {{event.action_token}} with the token you copied.
- Copy and paste the URL into your internet search bar.
- If everything is working properly, you should land on the landing page you have set up and see a green success message at the top of the page.
- You can also go to the Customers page in Ordergroove and search for the customer you are testing with. On their page, you should see in the "Recent Activity" section that the subscription was reactivated.
- Note that you can only use an action_token once, so to run additional tests you will need to use a different action token. You can cancel/reactivate the same test subscription customer multiple times to continue generating tokens for testing.
Test 1-Click Delay
- In Klaviyo, create an Order Reminder flow that includes a 1-Click Delay action.
- Mark the flow as Manual and your changes.
-
In Ordergroove, locate your test subscription (or create a new one). Update the Next Order Date to be 6 days out from today — or 5 days if it’s before 10am EST.
- Ordergroove runs the Order Reminder Job every day at 10am EST, targeting orders scheduled 5 days out.
- Example: If a subscriber’s next order is scheduled for January 6, the reminder email sends on January 1.
- Setting your test order 5–6 days out ensures it will be included in the next Reminder Job.
- Wait for the Order Reminder Job to run at 10am EST (either today or tomorrow, depending on when you set up your test). Once it runs, return to Klaviyo and send the message.
- When you receive the test email, click the 1-Click Delay link. You’ll be redirected to your website.
- Look for a banner message at the top third of the page confirming Success or Failure.
- If successful, you can go back to Ordergroove and confirm that the Next Order Date has been delayed.
- If unsuccessful, it’s usually due to an issue with the URL. Double-check for any URL typos in your Order Reminder Flow in Klaviyo.
Test 1-Click Upsell
You can create a separate email with upsell actions, but it must be triggered by the order reminder event in Klaviyo. This can be done by adding another email to your existing Order Reminder flow, or by creating a new flow based on the same order reminder event.
- In Klaviyo, create an email flow triggered by the order reminder event that includes 1-click actions for upsell. Include any items that would make sense for your customers to add to their upcoming shipment.
- Mark the flow as Manual, and Save.
-
In Ordergroove, locate your test subscription (or create a new one). Update the Next Order Date to be 6 days out from today — or 5 days if it’s before 10am EST.
- Ordergroove runs the Order Reminder Job every day at 10am EST, targeting orders scheduled 5 days out.
- Example: If a subscriber’s next order is scheduled for January 6, the reminder email sends on January 1.
- Setting your test order 5–6 days out ensures it will be included in the next Reminder Job.
- Wait for the Order Reminder Job to run at 10am EST (either today or tomorrow, depending on when you set up your test). Once it runs, return to Klaviyo and send the message.
- When you receive the test email, click the 1-Click Upsell link. You’ll be redirected to your website.
- Look for a banner message at the top third of the page confirming Success or Failure.
- If successful, you can go back to Ordergroove and confirm that the Next Order Date has been delayed.
- If unsuccessful, it’s usually due to an issue with the URL. Double-check for any URL typos in your Order Reminder Flow in Klaviyo.
Error Messages
If an 1-Click Action fails, Ordergroove displays an error message you and your customers can use to troubleshoot. The messages available depend on the type of 1-Click you're implementing:
Product Upsell Error Messages
| Error | What Your Customer Sees |
| Invalid token | The link is invalid. The product was not added to your order. |
| Expired token | This link is expired. The product was not added to your order. |
| Token already used | This link was previously used. The product was not added to your order. |
| Token with wrong context | This link is not valid for this action. The product was not added to your order. |
| Missing og_product_id | There was a technical error. The product was not added to your order. Please share the following code with customer service: "missing_og_product_id". |
| Invalid og_product_id | The product is unavailable or invalid. The product was not added to your order. |
| Invalid og_offer_id | The discount associated with your link is invalid. The product was not added to your order. |
| Other cases | The product was not added to your order. |
Subscription Upsell Error Messages
| Error | What Your Customer Sees |
| Invalid token | The link is invalid. The subscription was not created. |
| Expired token | This link is expired. The subscription was not created. |
| Token already used | This link was previously used. The subscription was not created. |
| Token with wrong context | This link is not valid for this action. The subscription was not created. |
| Missing og_product_id | There was a technical error. The subscription was not created. Please share the following code with customer service: "missing_og_product_id". |
| Invalid og_product_id | The product is unavailable or invalid. The subscription was not created. |
| Invalid og_offer_id | The discount associated with your link is invalid. The subscription was not created. |
| Missing og_every | There was a technical error. The subscription was not created. Please share the following code with customer service: "missing_og_every". |
| Missing og_every_period | There was a technical error. The subscription was not created. Please share the following code with customer service: "missing_og_every_period". |
| Other cases | The subscription was not created. |
Reactivate Error Messages
| Error | What Your Customer Sees |
| Invalid token | The link is invalid. Your subscription was not reactivated. |
| Expired token | This link is expired. Your subscription was not reactivated. |
| Token already used | This link was previously used. Your subscription was not reactivated. |
| Token with wrong context | This link is not valid for this action. Your subscription was not reactivated. |
| Subscription already active | Your subscription is already active. No changes have been made. |
| Other cases | Your subscription was not reactivated. |
Delay Error Messages
| Error | What Your Customer Sees |
| Invalid token | The link is invalid. Your subscription was not reactivated. |
| Expired token | This link is expired. Your subscription was not reactivated. |
| Token already used | This link was previously used. Your subscription was not reactivated. |
| Token with wrong context | This link is not valid for this action. Your subscription was not reactivated. |
| Subscription already active | Your subscription is already active. No changes have been made. |
| Other cases | Your subscription was not reactivated. |
FAQs
What happens if a customer clicks a 1-click action link multiple times?
1-click action tokens are only scoped for single use. Once a customer clicks a link, the action is taken. If they click it again, they will be redirected to your 1-click landing page and see an error message.
What happens if a customer takes a 1-click action by mistake?
When a 1-click action link is clicked, the action is taken automatically. There is no “undo button”, but if a customer unintentionally clicks a link, they can still easily self-correct within their subscription manager, or reach out to your support team to change the action. Here are the recommended corrections:
- Delay: Change the date on the upcoming order to desired date
- Reactivate: Cancel the subscription
- Cross-sell: Remove the added item from the upcoming order
Why didn't my popup show up?
When customers click your link, they'll be taken to the URL, and a success/failure popup will appear at the top of the page. The formatting of this box is determined by the CSS code hosted on your website.
The z-index is set to 6000, if this conflicts with your site the popup may appear under the content of your site and won't be visible.
Your technical team can alter the element CSS of your site to alleviate the issue. Our popup uses:
class="alert-container"Something like this could help:
.alert-container { z-index: 99999 !important; }