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 includesource: "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.