Collects as they arrive, acts daily

Get your weekly subscriber gains and losses

Every Monday you see how many readers joined, how many left, and your current total.

Runs: Collects as they arrive, acts daily
Apps: beehiiv
AI: Not needed
Access: API key

Send this to your assistant

Create a ClickRuntime automation: every Monday at 8am, email me how many beehiiv subscribers I gained and lost last week and my total subscriber count.

Paste it into your assistant. It tells you what it will send or change before it runs live.

Add to ChatGPT Add to Claude

First time? Adding ClickRuntime to your assistant takes about two minutes.

Why use it

Why teams use this automation

Growth for a newsletter is not a single number. New subscribers, unsubscribes and the net total each tell a different story. A week with 400 new subscribers and 350 unsubscribes looks fine on a total, but means something is wrong with retention. The publisher who only sees the total misses that churn is eating the gains, and decisions about promotion budgets rest on an incomplete picture.

During the week, ClickRuntime counts subscription and unsubscription events in weekly counters. On Monday it fetches the publication's current stats from beehiiv and emails you new subscribers, unsubscribes and the total. The three numbers appear together, so growth is judged properly.

Independent publishers and small media teams who set weekly targets will use it as a simple scoreboard. It also gives a sponsor a simple view of the audience.

What you get out of it

Churn cannot hide behind growth
Seeing unsubscribes beside new subscribers shows whether you are really growing. A weak retention problem becomes visible while it can still be fixed. A retention problem becomes visible while it can still be fixed cheaply and quickly.
Promotion spending can be judged
If you paid for a promotion, the week's numbers show what it delivered. Without them, you may spend more on something that brings readers who leave quickly. Spending decisions then rest on what each promotion actually delivered, not on hope.
Targets feel concrete
A weekly net number is easy to set goals against. A team can aim for a specific increase and see whether they reached it, which is more motivating than a vague aim to grow.
Trends appear across weeks
Looking at several Monday emails shows direction, such as growing slowly or flattening. You can respond to a trend before it becomes a problem. You can respond to a flattening trend long before it turns into a real problem.
Reporting to partners is easy
A sponsor, a co-founder or an investor can be sent the same numbers. Regular reporting builds trust, and you do not have to build a report each time. Your reports to sponsors stay consistent without any extra spreadsheet work.

How it works

What happens, step by step

Each time someone subscribes to or leaves your beehiiv newsletter, ClickRuntime adds it to that week's tally.
Every Monday it reads last week's numbers of readers gained and lost.
It fetches your current total of active subscribers from beehiiv.
You get one email with gained, lost, the net change and your total.

Before it runs live

Connect beehiiv
Paste your automation's link into the other app's webhook settings

What you get

RunsCollects as they arrive, acts daily

Get your weekly subscriber gains and lossestoday, 9:00Succeeded

Email · beehiiv growth last weekGained: 214 · Lost: 37 · Net: +177 · Total: 12,904

Build your own

Need it to work differently?

This template is a starting point. Copy the prompt and change it, or describe a different automation from scratch, with your own conditions, more apps or an AI step. Your assistant writes it, tests it and runs it on ClickRuntime.

Your own rules
Conditions, thresholds, filters and exceptions, written the way you'd explain them to a colleague.
Any number of apps
One automation can read from one app and update several others. Over 248 apps are ready, and anything with an API works too.
AI where it helps
Summaries, classification, extraction and drafts use ClickRuntime's built-in AI, with no extra key.
On a schedule or on each event
Runs as often as every 5 minutes, or the moment an app sends an event, and keeps track of what it already handled.

Changes you can ask for

Act only on the items that match your own rules, and skip the rest
Add an AI step, for example to summarize, sort or draft a reply
Add another app, for example also send it to Slack
Combine it with other beehiiv steps into one automation

Under the hood

The code that runs this automation

This is the Python script that runs each time the automation starts. Your AI assistant writes it for you when you send the prompt, and you allow each step in your assistant. To change how the automation works, describe the change to your assistant and it updates the script for you. For every function it can use, see the script reference.

weekly_growth_report.pyexample

from clickruntime import on_event, on_trigger, credentials, http, state, notify

PUB_ID = "pub_00000000-0000-0000-0000-000000000000"

@on_event
def count(event):
    kind = event.json.get("event_type")
    if kind in ("subscription.created", "subscription.deleted"):
        state.increment_metric(kind, ttl_days=60, bucket="week")
    return {"counted": kind}

@on_trigger
def report(event):
    def last_week(key):
        points = state.query_metric(key, bucket="week")
        return points[-2]["value"] if len(points) >= 2 else 0
    gained, lost = last_week("subscription.created"), last_week("subscription.deleted")
    pub = http.get(f"https://api.beehiiv.com/v2/publications/{PUB_ID}", params={"expand[]": "stats"},
                   headers={"Authorization": f"Bearer {credentials.secret('BEEHIIV_API_KEY')}"}).json()["data"]
    total = pub["stats"]["active_subscriptions"]
    notify.email_me("beehiiv growth last week", f"Gained: {gained}\nLost: {lost}\nNet: {gained - lost:+}\nTotal: {total:,}")
    return {"gained": gained, "lost": lost, "total": total}

FAQ

Common questions

Where do the new and unsubscribed counts come from?

ClickRuntime counts the subscription and unsubscription events that beehiiv sends during the week. That gives exact weekly figures. On Monday it also reads the total from the publication stats so all three figures come from beehiiv's own data.

What if I turn it on in the middle of a week?

The first report will cover only the part of the week since the flow started, so its counts will look low. From the following Monday, the counters cover a full week, and the numbers are comparable week to week.

Does it separate free and premium subscribers?

It can. The events say which kind of subscription changed, so the email can show free and premium counts separately. That is helpful if you are trying to convert free readers into paying ones and want to see that effort reflected.

What permissions does it need?

API key. Nothing else in your accounts is used.

Does it need AI?

No. It runs without AI, so it doesn't use your plan's AI allowance.

How many runs does it use?

One run each time it checks. Checks that find nothing new and stop right away aren't counted.

Can I change how it works?

Yes. Describe the change to your AI assistant, for example a different schedule, channel or filter. It updates the automation, tests it and tells you what changed.

Collects as they arrive, acts daily