Show your newsletter subscribers on your iPhone

Short answer: send your newsletter subscribers to WidgetDash with one HTTP request, then add the WidgetDash widget to your iPhone Home Screen or Lock Screen. It updates every time you push a new value, and it is free for up to 5 numbers.

Your list is your most durable audience, and watching it grow is quietly motivating. Most email platforms expose the subscriber count over an API or webhook, so a small scheduled call gets the number. Push it and the widget becomes a gentle nudge to keep publishing.

Push it with one request

A source is created automatically the first time you push to it, so there is no setup step. Send your newsletter subscribers like this:

curl -X PUT https://api.widgetdash.app/api/v1/data/newsletter_subs \
  -H "Authorization: Bearer YOUR_WRITE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "display_name": "Newsletter",
    "icon": "envelope.fill",
    "category": "Creator",
    "metrics": [
      { "label": "Subscribers", "value": "3,981" },
      { "label": "This week", "value": "+112" }
    ]
  }'

• The value is a plain string, so format it however reads best: "$8,420", "99.98%", "+58".
• icon is an SF Symbol name. Here we use envelope.fill.
• Push to the same source_key again any time and the widget updates in place.

Add it to your iPhone

1. Sign up free and copy your WRITE key from the dashboard.
2. Install the WidgetDash iOS app (free on the App Store) and connect with the dashboard QR code or your READ key.
3. Long-press the Home Screen, tap +, search WidgetDash, pick a size, then choose this source.

Small Lock Screen widgets are supported too, so your newsletter subscribers can sit right under the clock.

Questions

Related widgets

See all WidgetDash use cases · How to see any number on your iPhone