Skip to content

Postscript

Connect Postscript to Cadence — API token setup, automation configuration, and subscriber requirements.

Postscript is Cadence’s SMS integration for Shopify-native text message marketing. Cadence sends prediction events to Postscript; your Postscript automations send the SMS messages.

What Postscript receives from Cadence

  • Custom eventscadence_prediction events with prediction type, product info, and ConvertCart links
  • Subscriber attributes — a reduced set of cadence_* properties synced to existing SMS subscribers

Connecting Postscript

Go to Integrations → Postscript in the Cadence app.

  1. Click Connect
  2. In Postscript: Admin → API → Private API token (or Store API)
  3. Create a token and copy it
  4. Paste the token in the Cadence connect modal
  5. Click Connect

API tokens are encrypted at rest and never shown again after saving.

Important: existing subscribers only

Postscript profile sync only updates existing SMS subscribers matched by phone number (or email lookup). Cadence does not create new Postscript subscribers.

This means:

  • Customers must already be Postscript SMS subscribers to receive profile property updates
  • If a customer isn’t in Postscript, they’ll still receive SMS if your automations trigger on the event — but their profile won’t have Cadence properties for segmentation
  • Ensure your Shopify-Postscript integration is syncing subscribers properly

Required setup in Postscript

Create automations

Create one automation per prediction type:

  1. Automations → Create automation
  2. Set trigger: Event → cadence_prediction
  3. Filter by prediction_type:
    • due_to_replenish for replenishment
    • about_to_lapse for lapse prevention
  4. Design the SMS message with event properties
  5. Activate the automation

See Sequences and flows for guidance.

SMS message tips

  • Keep messages under 160 characters when possible
  • Include the cart_url as the clickable link
  • Use {first_name} and {product_name} for personalization
  • One CTA per message

Example:

Hey [first_name]! Your [product_name] is running low. Reorder here: [cart_url]

Replace bracketed placeholders with the corresponding event properties from your automation builder.

Profile attributes

Cadence syncs cadence_* attributes to matched Postscript subscribers. Attributes update daily alongside event delivery.

Use attributes for:

  • Segmenting subscribers by prediction status
  • Targeting win-back campaigns at lapse-risk customers

Troubleshooting

Issue Solution
API token rejected Create a new Private API token in Postscript admin
Automations not triggering Verify event type is cadence_prediction and automation is active
Profile sync not working Customer must be an existing Postscript subscriber with a matching phone number
SMS not reaching customers Confirm customer is a Postscript subscriber and has a valid phone number

Where to go next