FAQ
Frequently asked questions
How LiveActivity works, how billing works and how to get the most out of it.
General
What does LiveActivity do?
It starts, updates and ends iOS Live Activities for your app. You call a REST API from your backend; we keep the push tokens, build the APNs payloads, send them at the right priority and tell you by webhook what happened.
Which platforms?
iOS apps in Swift and React Native / Expo. Your backend talks to a plain REST API from any language.
What about Android?
Not today. Live Activities are an iOS feature (Lock Screen and Dynamic Island), and the API is built around ActivityKit and APNs.
Does it work with React Native and Expo?
Yes. The Expo config plugin adds the widget extension, the Info.plist keys and the push entitlement on prebuild, with a default Lock Screen and Dynamic Island view you can replace with your own SwiftUI file. It needs a development build, not Expo Go.
Do I still need ActivityKit in my app?
Yes, for the UI: you define your ActivityAttributes and the Lock Screen and Dynamic Island views with ActivityKit and WidgetKit as usual. The SDK takes over the rest: it reports push and push-to-start tokens, and we send the APNs pushes.
Do you see my APNs key?
It is stored encrypted and used only to sign pushes for your app. You can replace it any time.
Can I use it from Claude or ChatGPT?
Yes. The Pro and Business plans include an MCP server, so AI apps can start and inspect activities in your workspace.
Live Activities
Can a Live Activity start at a set time?
Yes. Pass startAt and we send the push-to-start at that moment (iOS 17.2+). On iOS 26 the SDK also schedules it on the device, and we only push if the device didn't start it.
Why do my Live Activity updates not arrive?
Usually a stale per-activity token, a payload that doesn't match the app's ContentState, or Apple's priority budget. We track tokens, check payloads against your ContentState before sending and send quiet updates at low priority.
What happens when a payload doesn't match?
The API answers 422 with the field that differs, instead of APNs accepting the push and iOS dropping it silently.
How do I know an activity was delivered?
Every push, APNs answer and SDK report shows in the activity's timeline, and signed webhooks tell your backend about starts, token changes, ends and failures.
Billing
Is there a free plan?
Yes. Every account starts with a 14-day trial of the Pro plan, no credit card needed, and then stays on Free: 100 Live Activities a month, 1 app, no time limit.
What counts as a Live Activity?
One activity started, by the API, a schedule or the app itself, in a calendar month (UTC). Updates and ends are not counted, and one activity sent to several devices of a user counts once.
What happens when I reach my limit?
New starts are refused with a 402 until the next month or an upgrade. Activities that are already running keep getting updates and ends.
Can I change plans later?
Yes, upgrade or downgrade from Billing → Invoices & payment. Paddle prorates the difference.
Can I cancel any time?
Yes. Cancel from the Billing page; your plan stays active until the end of the paid period.
Who handles payments and VAT?
Paddle, our merchant of record. Prices exclude VAT; Paddle adds it at checkout where it applies and sends your invoices.
Something else? Write to support@liveactivity.dev.
Ready to ship Live Activities?
# start one from your backend
curl -X POST https://liveactivity.dev/api/v1/activities \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"appId": "app_...",
"userId": "user_42",
"attributesType": "DeliveryAttributes",
"attributes": { "orderId": "1234" },
"contentState": { "eta": 15, "status": "cooking" }
}'
→ on the Lock Screen