# Postscript x Smartrr Integration

Last updated: May 14, 2025

## Setup

{% hint style="warning" %}
**📲 Note:** Smartrr does not currently act as a service to gather SMS subscribers. For this integration, we are assuming that your customers are already subscribed via Postscript. For instructions on how to gather Postscript subscribers, [<mark style="color:blue;">**click here**</mark>](https://postscript.io/grow-your-list). \
\
You may also need to be on a Postscript plan that allows integrations. Please contact your Postscript representative directly should you have questions on upgrading your plan.&#x20;
{% endhint %}

To integrate Postscript and Smartrr, first create a security key pair from your Postscript dashboard under Settings > API.

![](/files/H9KI6TaGMKEAgd4fyoXT)

Once created, show and copy your **Private Key** to your clipboard. Paste this key in your Smartrr admin under **Integrations**.

<figure><img src="/files/eqUCBZ9YEJNLZLGQcOsg" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/hMsyjaebpO0JX0VcCeFv" alt=""><figcaption></figcaption></figure>

Click **Confirm**. Once saved, your integration setup is complete!

## Postscript Triggers

The Smartrr x Postscript integration works by sending **triggers** on a subscriber-level that can be used to create automations inside the Postscript admin based on the below events.&#x20;

<mark style="color:green;">In green</mark> we've outlined some example copy for SMS automations that your shop could create using these triggers.&#x20;

[<mark style="color:blue;">Jump to the section below</mark>](#postscript-automations) to learn how to set up **automations** in Postscript using Smartrr triggers.&#x20;

<table><thead><tr><th width="210">Trigger</th><th>Description</th><th>Potential SMS Example</th><th data-hidden></th><th data-hidden></th><th data-hidden></th></tr></thead><tbody><tr><td><strong>🆕 Subscription Created</strong></td><td>Sent whenever a new subscription is created</td><td><mark style="color:green;">Hi {first_name}, thanks for your subscription! Manage your subscription by creating an account here: {account_page_link}</mark></td><td></td><td></td><td></td></tr><tr><td><strong>🔁 Upcoming Order</strong></td><td>Sent 3 days before upcoming order, customer provided option to skip</td><td><mark style="color:green;">Heads up: your upcoming subscription will ship in 3 days. Not quite ready? Just reply SKIP</mark></td><td></td><td></td><td></td></tr><tr><td><strong>⏭ Skipped Order</strong></td><td>Sent when a customer skips after receiving the upcoming order notification</td><td><mark style="color:green;">Confirmed! Your upcoming subscription will be skipped. Your next order will be on {new_delivery_date}</mark></td><td></td><td></td><td></td></tr><tr><td><strong>💳 Payment Method Updated</strong></td><td>Sent whenever a customer successfully updates their payment method</td><td><mark style="color:green;">Hi {first_name}, your payment method has been successfully updated!</mark></td><td></td><td></td><td></td></tr><tr><td><strong>❗️Payment Method Failed</strong></td><td>Sent whenever a payment method for an upcoming order has failed</td><td><mark style="color:green;">Your recent payment wasn't completed. To update your payment method, click here: {account_page_link}</mark></td><td></td><td></td><td></td></tr><tr><td><strong>❌ Customer Deactivated</strong> </td><td>Sent when when a customer's last subscription has been canceled </td><td><mark style="color:green;">We're reaching out to confirm your subscription has been canceled. We're sorry to see you go.</mark></td><td></td><td></td><td></td></tr></tbody></table>

## Postscript Automations

To create an automation in Postscript navigate to **Automations** under **Messaging**.&#x20;

{% hint style="info" %}
&#x20;**Note:** For Smartrr's integration, please use **Legacy Automations**.&#x20;
{% endhint %}

![](/files/nUIa0OKinESlaMluS9rg)

Click **Create Automation**. Be sure to choose the Legacy option.&#x20;

![](/files/nUMIZp69YWeCUJ7YgTav)

Select Custom Automation.

![](/files/q3Y6b8dR8DOo3UWUu9Uq)

Select any of the triggers that begin with **Smartrr:** to proceed.&#x20;

![](/files/khPHpktwgE59PnMB9O3S)

You're now ready to add your desired SMS copy and set a wait period. You can set a wait time as low as 1 minute.&#x20;

![](/files/mvUDFnXxmBhcqYqPhTBK)

To add dynamic tags to your SMS automation, click **More** and **Add Tags**. The default tags scoped to Postscript include <mark style="color:purple;">`shop_name`</mark>, <mark style="color:purple;">`first_name`</mark>, <mark style="color:purple;">`last_name`</mark> and <mark style="color:purple;">`shop_link`</mark>. To add Smartrr-specific dynamic tags, reference the below table for tags associated with each trigger:

![](/files/7X7IXQnlmA4kjUNxqqhn)

<table><thead><tr><th width="267">Trigger</th><th>Associated Tags</th><th data-hidden></th></tr></thead><tbody><tr><td><strong>🆕 Subscription Created</strong></td><td><pre><code>{account_page_link}
{delivery_frequency}
{delivery_frequency_unit}
</code></pre></td><td></td></tr><tr><td><strong>🔁 Upcoming Order</strong></td><td><pre><code>{account_page_link}
</code></pre></td><td></td></tr><tr><td><strong>⏭ Skipped Order</strong></td><td><pre><code>{account_page_link}
{new_delivery_date}
</code></pre></td><td></td></tr><tr><td><strong>💳 Payment Method Updated</strong></td><td><pre><code>{account_page_link}
</code></pre></td><td></td></tr><tr><td><strong>❗️Payment Method Failed</strong></td><td><pre><code>{account_page_link}
{retry_num} 
</code></pre></td><td></td></tr><tr><td><strong>❌ Customer Deactivated</strong> </td><td><pre><code>{account_page_link}
</code></pre></td><td></td></tr></tbody></table>

{% hint style="info" %}
**Tip:** Make sure you save your automation and that it's enabled by sure the **Active** toggle is flipped to green.&#x20;

**Reminder:** in the United States, automation "waking hours" are from 11AM to 9PM.&#x20;
{% endhint %}

![](/files/acJckDRRgroxf2L4Ims7)

### Customer Keyword Responses

Your customers can use specific keywords to trigger certain actions on their subscription.

#### Skip

<table><thead><tr><th width="129.66666666666666">Response</th><th>Action</th></tr></thead><tbody><tr><td>SKIP</td><td>Skips customer's next scheduled subscription order.</td></tr></tbody></table>

<figure><img src="/files/n2xpRwvD92KEZU0J64vn" alt=""><figcaption><p>Example of "SKIP" response.</p></figcaption></figure>

To set up a prompt for the customer to SKIP, set up a legacy automation with the automation trigger: **Smartrr: Upcoming Order**.&#x9;

{% code overflow="wrap" %}

```
{shop_name}: Heads up: your upcoming subscription from {shop_name} will ship in 3 days. Not quite ready? Just reply SKIP. To manage your subscription go to {account_page_link}
```

{% endcode %}

<figure><img src="/files/bLNNt7ReiY4I2yuWZhMi" alt=""><figcaption></figcaption></figure>

To set up a response to SKIP, set up a second legacy automation in response to the trigger: **Smartrr: Order Skipped**.&#x20;

{% code overflow="wrap" %}

```
{shop_name}: Confirmed! Your upcoming subscription will be skipped. Your next order will be on {new_delivery_date}. To manage your subscription go to {account_page_link}
```

{% endcode %}

<figure><img src="/files/fXh0md5ukb8NdXqz0PPc" alt=""><figcaption></figcaption></figure>

### FAQs

1. **Where can I track Smartrr messages in Postscript?** \
   You can view your message analytics in your Postscript dashboard under Analytics > Messages. You can also view direct customer responses to automated messages in Messaging > Responses.

![](/files/nAO7VzWlOOied6oucL2s)

![](/files/jYQIxaiKgCQIypXEjh4E)

### 🕒 Coming soon...

The below features will be coming soon to the Smartrr x Postscript integration:&#x20;

* Text DELAY to delay a subscription
* Ability to pull in dynamic Shopify customer data into SMS


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.smartrr.com/docs/support/integrations/postscript-x-smartrr-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.