Skip to main content

Overview

Circuly forwards subscription lifecycle, payment, billing, and invoice events to Klaviyo via the Events API v3. Once connected, each event is attached to the matching customer profile in Klaviyo so you can trigger flows, build segments, and run win-back campaigns from real subscription activity.
Basic setup — connecting your API key, sending test events, and installing starter templates and flows — is handled inside Circuly Subscriptions under Integrations → Klaviyo. This page is the reference for everything that ships after that setup: event properties, advanced flow patterns, and segment prompts you can use with Klaviyo’s MCP server.

Events reference

Every event includes the customer profile (email, first name, last name), a Klaviyo metric name, and the event-specific properties listed below. All events also include source: "circuly_subscriptions". Test events additionally include test: true.

Subscription lifecycle

Payments

Billing

Invoices

Payload structure

All events are sent in the Klaviyo Events API v3 format:

Advanced flow patterns

The starter flows installed by Circuly are single-step. Use the prompts below with Klaviyo’s MCP server to build richer multi-step flows.

Payment recovery sequence

Cancellation win-back drip

Pause re-engagement

Welcome series

Invoice escalation

Buyout upsell after loyalty

Retry awareness

Segments

Use these prompts to create customer segments for targeted campaigns.

At-risk subscribers

Paused subscribers

Churned subscribers

Loyal subscribers

Overdue invoices

Buyout candidates

Troubleshooting

Need help?

Email us at miguel@circuly.io with your store URL and a description of what’s happening.