Klaviyo Cost Tuning
Overview
Optimize Klaviyo costs through active profile management, list hygiene, event sampling, and API usage monitoring. Klaviyo bills primarily by active profiles and message volume, not API calls.
Prerequisites
- Access to Klaviyo billing dashboard
- Understanding of active profile definition
klaviyo-api SDK for programmatic management
Klaviyo Pricing Model
Klaviyo bills based on active profiles (contacts who have received or been targeted by marketing), not API requests.
| Component | How It's Billed | Cost Driver |
|---|
| Email | Per active profile tier | Number of marketable profiles |
| SMS | Per message sent + carrier fees | Message volume |
| Push | Included with email plan | N/A |
| API calls | Free (rate limited, not billed) | N/A |
| Reviews | Per request volume | Review request sends |
Email Pricing Tiers (Approximate)
| Active Profiles | Monthly Cost |
|---|
| 0 - 250 | Free |
| 251 - 500 | $20/mo |
| 501 - 1,000 | $30/mo |
| 1,001 - 1,500 | $45/mo |
| 1,501 - 5,000 | $60-$100/mo |
| 5,001 - 10,000 | $100-$150/mo |
| 10,001 - 25,000 | $150-$375/mo |
| 25,001+ | Custom pricing |
Key insight: Reducing active profiles has the biggest cost impact. Cleaning suppressed/unengaged contacts directly reduces your bill.
Instructions
Work the levers in order — active-profile reduction has the largest impact, so start
there before touching event sampling or API monitoring. Each step maps to a klaviyo-api
routine in the full walkthrough; the complete five-step implementation
carries the runnable code for every step, and worked examples show
the dollar impact of each.
- Audit active profile count — page through
ProfilesApi.getProfiles with a minimal
fieldset to establish the current tier. Skeleton below.
- Identify unengaged profiles — query an "Unengaged 180+ Days" segment via
SegmentsApi.
- Suppress unengaged contacts — unsubscribe (stays but unmarketable = not billed) or
add a global suppression property. This is what actually lowers the bill.
- Sample non-critical events — keep revenue events at 100%, sample high-volume/low-value
events (
Viewed Product, Page View) to cut ingestion.
- Monitor API usage — wrap SDK calls in a rate tracker to catch runaway processes before
they trip the 700 req/min limit.
Establish a session once, then run the audit (Step 1):
import { ApiKeySession, ProfilesApi, SegmentsApi } from 'klaviyo-api';
const session = new ApiKeySession(process.env.KLAVIYO_PRIVATE_KEY!);
const profilesApi = new ProfilesApi(session);
let totalProfiles = 0;
let cursor: string | undefined;
do {
const response = await profilesApi.getProfiles({
pageCursor: cursor,
fieldsProfile: ['email'],
});
totalProfiles += response.body.data.length;
const nextLink = response.body.links?.next;
cursor = nextLink ? new URL(nextLink).searchParams.get('page[cursor]') || undefined : undefined;
} while (cursor);
console.log(`Total profiles: ${totalProfiles}`);
Steps 2–5 (segment query, suppression job, event sampling, usage tracker) live in the
full implementation walkthrough.
Output
Applying this skill produces:
- A current active-profile count and the pricing tier it falls into (see the tables above).
- A list of unengaged profiles (180+ days no open/click) eligible for suppression.
- A suppression run — profiles unsubscribed or globally suppressed, lowering the billed
active count (often enough to drop a tier).
- An event-sampling config that keeps revenue-critical events at 100% while sampling noise.
- A
KlaviyoUsageTracker emitting [Klaviyo] High API rate: N req/min warnings before the
700 req/min steady limit is reached.
Examples
- Drop a pricing tier: suppressing 3,100 unengaged profiles takes an account from 12,400 to
9,300 active profiles, moving it from the 10,001–25,000 tier down to 5,001–10,000.
- Cut SMS spend: gating the abandoned-cart flow on an engaged-only segment stops full-list
texting and its per-message carrier charges.
- Sample noisy events: a 0.25/0.10 sample on
Viewed Product/Page View cuts ingestion of
those events ~75–90% with no loss to revenue attribution.
See references/examples.md for the full before/after figures and code
for each scenario.
Cost Reduction Checklist
Error Handling
| Issue | Cause | Solution |
|---|
| Unexpected bill increase | Unengaged profiles grew | Run suppression script |
| SMS costs spiking | Flow sending to full list | Add engaged-only segment filter |
| Duplicate profiles | Multiple identify calls | Merge duplicates, use createOrUpdateProfile |
| API rate limits hit | Bulk operations | Use queue with concurrency control |
Resources
