iPhone widgets from your own server
Ask your AI for a widget.
Webhook Widget turns JSON from any URL into a native Home Screen widget. Your agent writes the endpoint, you add the URL, and your data is on your phone. No Xcode, no developer account.
Add a GET endpoint to this project at /widget.json that returns a Webhook Widget view showing [what you want to see]. Follow the format and the good-practice rules at https://webhookwidget.com/llms.txt, check it renders in the headless playground, then give me the webhookwidget://register link and a QR code so I can add it on my phone.
Works with Claude Code, Codex and Cursor
How it works
Your endpoint returns JSON. The app draws it at every size, in light and dark.
- Step 1
Get some JSON
Ask your agent, write a handler yourself, or start with one of our examples. Any language, any host: a Cloudflare Worker, a cron job, a Raspberry Pi.
- Step 2
Add the URL
Give it a name in the app, add a Webhook Widget to your Home Screen and pick it.
- Step 3
Change it from your server
The layout lives in the response. Edit your handler and the widget follows on its next refresh, on every phone that shows it.
You could build a Swift widget. Here's what that involves.
Your agent can write the Swift. You still need a Mac, Xcode, signing and a developer account.
| A Swift widget of your own | Webhook Widget | |
|---|---|---|
| What you need | A Mac, Xcode and an Apple developer account (£79 / US$99 a year) | An iPhone, and a URL that returns JSON |
| How long it keeps working | 7 days on a free account, then rebuild from your Mac | It doesn't expire |
| Changing it | Edit, rebuild, re-sign, reinstall, or wait for App Review | Change the JSON and deploy |
| Putting it on a friend's phone | Pair their phone with your Mac, or set up TestFlight | Send a link. Free for them |
| Can your agent do all of it? | No. Signing in to Xcode, pairing and Developer Mode need you | Yes, everything on the server |
| Light, dark, tinted, Lock Screen, every size | You write each one | Included |
| Refresh | Up to iOS, about every 15 to 60 minutes | The same. iOS decides for every widget |
Apple's figures as of October 2026.
Fifteen examples to copy
Each example shows its payload. Add any of them in the app before you write an endpoint.
AI spend this month
What Claude and OpenAI have cost so far, against a monthly budget.
Server health
CPU, memory, disk and load.
Parcel delivery
An arrival window with a live progress bar.
Weather
Conditions now and the next six hours.
Price
Free for 7 days. US$3.99 once.
Build and preview as much as you like for free. When you want your own widgets on your Home Screen, start the 7-day trial: it's free, it starts only when you choose to start it, and nothing is charged when it ends. Then one purchase keeps them there for good and lets you share them.
No subscription and no account. Your phone fetches your URL directly. Widgets shared with you are always free.
Questions
What do I need?
An iPhone on iOS 26.2 or later (or an iPad on iPadOS 26.2), and a URL that returns JSON over HTTPS. The examples in the app work before you have a URL of your own. No Mac, no Xcode and no account.
Why pay for this?
You pay once for the iPhone app: a native renderer for every size, mode and iOS update, sharing that's free for the people you share with, and the docs and playground. It costs less than one month of most widget subscriptions.
Why not just ask my AI to write a Swift widget?
It can write the Swift. Then you need a Mac, Xcode, signing, and a £79-a-year developer account or a build that stops working after 7 days. Every change means a rebuild, and every friend means TestFlight. With Webhook Widget your agent only writes the endpoint, and you never open Xcode.
How is this different from Scriptable or Widgy?
They run on your phone: you write JavaScript in Scriptable, or design layers in Widgy. Here the widget is drawn from what your server returns, so you build it where you already code, in any language. Change it once and every phone showing it updates.
Does my data go through your servers?
No. Your phone fetches your URL directly. We have no servers in the middle and collect no data.
How often does it refresh?
iOS decides, for every widget on the phone: typically every 15 to 60 minutes, more often for widgets you look at a lot. You can ask for a rate in your response, and timelines and live countdowns keep a widget accurate between fetches.
When does the trial start?
Only when you choose. First the app shows you how long it lasts, what it covers and what Premium costs, and the trial starts only when you tap “Start free trial” on that screen. Previewing in the app, adding one of the examples, and keeping a hook someone shared with you never start it.
What happens when the trial ends?
Nothing is charged. Your own widgets show “Trial ended” until you unlock Premium. You can still edit and preview them in the app, and the examples and widgets shared with you keep working.
Someone shared a widget with me. What do I do?
Open their link on your iPhone and tap Copy Link and Get the App, which copies the link as the App Store opens. Once the app is installed, open it and tap Paste (or open the link again). The app shows who shared it, and it's yours when you tap Keep; then it shows you how to put it on your Home Screen. A widget someone shares with you is free, for good, with no trial and no purchase.
Is it a subscription?
No. One purchase, and it's yours on every device signed in to your Apple Account. To put a widget on someone else's phone, share it: they don't need to buy anything.