Beehiiv
Newsletter subscriber growth, open rates and paid subscription revenue — read-only.
Why founders connect Beehiiv
Newsletter businesses live and die by subscriber growth and open rates — but checking Beehiiv daily is friction that breaks your morning routine. Fold puts your subscriber count and recent open rates next to your revenue and traffic so you can see the full content-to-conversion picture without switching apps.
How your data flows
From Beehiiv to your Fold dashboard
This is the exact sequence every time Fold runs its daily sync. Nothing runs outside this pipeline.
Beehiiv API
Encrypted API key
Your API key is stored encrypted (AES-256) in our database. It is sent only to Beehiiv's API over TLS 1.3 and never logged.
Read-only API requests
5 HTTP GET calls per sync
Fold makes 5 read-only requests to Beehiiv's API — the exact endpoints are documented in the section below. No write requests are ever made.
Filter & aggregate
Personal data stripped before storage
The raw API response is processed in memory. Only aggregate numbers (totals, counts, rates) are extracted. Any field containing personal information — names, emails, IDs — is discarded and never written to disk.
Stored in your account
AES-256 at rest · row-level isolation
The filtered snapshot is written to your isolated tenant in our database, encrypted at rest. Row-level security ensures no other Fold user can read your data — not even via a misconfigured query.
Shown in your dashboard
Overview · Analytics · AI Digest
The stored aggregate numbers surface across your Fold dashboard — the Overview tile, Analytics tab charts, and the AI-generated daily digest. No raw data from the API is ever returned to the frontend.
Step 1 — How you connect
The exact connection flow
Here is precisely what happens when you connect Beehiiv to Fold, step by step.
- 1Go to your Beehiiv dashboard → Settings → API.
- 2Generate a new API key — name it "Fold Analytics".
- 3Copy the key and paste it into Fold's Settings tab, along with your Publication ID.
- 4Fold validates the key and performs an initial sync.
- 5Delete the key from Beehiiv at any time to immediately revoke access.
Step 2 — Permissions we request
Exactly what access Fold asks for
We request the minimum permissions needed. No more.
- Read-only API key — access to publication stats, subscriber counts and email performance.
- No write access. Fold cannot send newsletters, add subscribers or modify publication settings.
Step 3 — API calls Fold makes
Every request we send to Beehiiv
These are the exact API endpoints Fold calls during each sync, and why.
GET /v2/publications/{id}
Total subscriber count and publication metadata.
GET /v2/publications/{id}/subscriptions
New, active and churned subscriber counts.
GET /v2/publications/{id}/posts
Recent newsletters to pull performance metrics for.
GET /v2/publications/{id}/posts/{id}/stats
Open rate, click rate and recipients per issue.
GET /v2/publications/{id}/premium_subscriptions
Paid upgrade conversions and premium subscriber count.
API impact: Fold makes 5 API requests per sync. Beehiiv's API is rate-limited to 120 requests/minute — our usage is negligible.
What we store
Exactly what lands in our database
Every field we persist — with a real example and the reason it exists. Nothing more is stored.
| Field | Example value | Why we store it |
|---|---|---|
| Total subscriber count | 3,400 subscribers | Email KPI tile. |
| Net new subscribers (period) | +180 this month | Growth metric. |
| Churn count (period) | 22 unsubscribed | List churn metric. |
| Average open rate (last 5 issues) | 44.2% | Engagement KPI. |
| Average click rate (last 5 issues) | 6.1% | Engagement KPI. |
| Premium subscriber count | 87 premium | Paid upgrade metric. |
| Free-to-paid conversion rate | 2.6% | Monetization KPI. |
What a daily sync actually stores
One day's record — verbatim
This is a real-looking example of the row Fold writes to your account after a single sync. Every field, every value — nothing hidden.
{
"date": "2025-04-23",
"total_subscribers": "3400",
"new_subscribers": "180",
"premium_subscribers": "87",
"posts_published": "1",
}
No customer names. No emails. No transaction IDs. Just numbers.
What we never store
Data Fold never touches
These fields are explicitly excluded. Even if the Beehiiv API returns them, Fold ignores and discards them before any storage step.
- Individual subscriber email addresses, names or profile data
- Individual open or click events per subscriber
- Newsletter content, subject lines or post body text
- Subscriber referral codes or referral network data
- Stripe payment details linked to premium subscriptions
- Your Beehiiv account password
What Fold never does
Hard limits — enforced at the API level
These aren't just policies — they're technically impossible given the permissions we request. Beehiiv's own API enforces them.
- Send newsletters or create posts
- Add, update or remove subscribers
- Modify premium pricing or subscription settings
- Access subscriber personal information
- Share your newsletter data with any third party
- Use your data to train AI models
Privacy note — Beehiiv specific
Fold reads publication-level aggregate statistics — total counts, averages and rates. Individual subscriber email addresses and reading behaviour are never accessed or stored.
Data retention
How long we keep it
Synced metrics are retained while your Fold account is active and purged within 24 hours of disconnecting or account deletion.
Refresh frequency
How often we sync
Automatic sync every 24 hours. Manual refresh available from Settings.
How to revoke access
You are always in control
You can disconnect Beehiiv from Fold at any time — from either side. Both options immediately stop all data access.
From Fold
Settings → Beehiiv → Disconnect. All synced Beehiiv data is deleted immediately.
From Beehiiv directly
Beehiiv Dashboard → Settings → API → Delete the Fold Analytics key.
Open Beehiiv settingsSecurity standards
How your credentials are protected
AES-256 encryption at rest
Your API key is encrypted with AES-256 before being written to our database. It is never stored, logged, or returned in plaintext.
TLS 1.3 in transit
All API calls from Fold to Beehiiv use TLS 1.3. Your credentials cannot be intercepted in transit.
Read-only enforcement
Beehiiv's own API enforces the read-only permissions server-side. Even if Fold's code had a bug, the platform would reject any write request.
Row-level security
Your synced data is isolated in our database with row-level security. No other Fold user can query your data.
FAQ
Questions about the Beehiiv integration
Can Fold see who my individual subscribers are?
No. We read aggregate statistics — total subscriber counts, average open rates, paid conversion rates. We never access the subscriber list or individual subscriber profiles.
Can Fold send emails to my list or publish posts?
No. The Beehiiv API key is read-only. No write operations are possible with Fold's integration.
Does Fold access my premium subscribers' payment information?
No. We only count premium subscribers (the total number). Payment details are handled by Beehiiv and Stripe directly and are never accessible to Fold.
Other live integrations
See how other connections work
Ready to connect Beehiiv?
Start your free trial — no credit card
7 days full access. Connect Beehiiv and every other live integration. Cancel anytime. Your data deleted on request, immediately.