Webhook Widget

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.

Paste this into your coding agent

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.

  1. 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.

  2. Step 2

    Add the URL

    Give it a name in the app, add a Webhook Widget to your Home Screen and pick it.

  3. 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.

Browse all examples

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.

Put your data on your Home Screen.