§ Docs · Guide 8 of 11

Webhooks & self-hosting

The optional webhook feature posts your data, in your chosen format, to a server you control. Off by default, fully configurable, and nothing is sent until you set it up.

Platform
iOS 17+
Updated
August 22, 2026
Reading
4 min
Back to

Pro feature, off by default. Webhooks can send your location data off your device — to a server you choose. Nothing is sent until you configure an endpoint, and the settings screen leads with a prominent warning card.

What it's for

If you run your own location infrastructure — Dawarich, an OwnTracks recorder, Traccar, or anything that accepts HTTP posts — webhooks turn iso.me into a source for it. Known-good endpoint patterns:

ServiceEndpoint shapeFormat
Dawarich…/api/v1/owntracks/pointsOwnTracks
OwnTracks recorder…/pubOwnTracks
Traccarper your installationJSON / OwnTracks
Anything elseany HTTPS URLany of the 8 formats

Configuration

Send modes

ModeBehavior
Real-time (default)Each newly recorded point is sent as it's saved. On launch the sender “arms” itself first, so enabling webhooks never bulk-dumps your history.
By countPoints queue and flush every 5 / 10 / 25 / 50 / 100 points.
By timeQueued points flush every 1–60 minutes.
ManualNothing sends automatically; Send now posts your entire saved history (visits and points).

Batch modes show a live queue count with a Flush queue button. Failed sends retry automatically with backoff on network errors and server hiccups (5xx, timeouts, rate limits); authentication failures don't retry — they surface as an error. Test connection posts a single harmless sample point so you can verify an endpoint before committing.

Know your destination. This is the one feature that transmits your location data off-device. Use endpoints you trust (ideally your own servers), and remember queued-but-unsent points in batch modes are lost if iOS terminates the app before a flush.