SyncFitSyncFitGet SyncFit
How to

Guides for every workflow.

Short, numbered, and written for the screens you actually see. Each guide takes a minute or two.

Connect Apple Health

  1. Open SyncFit on iPhone and swipe through the introduction. On the last slide tap Connect Apple Health, or tap it later on Home.
  2. iOS shows the Health permission sheet once. Turn on the categories you want SyncFit to read. Turn All Categories On is the fastest choice; you can still export a subset later.
  3. Tap Allow. Home shows today’s readings within a few seconds.

Changed your mind? iOS Settings → Health → Data Access & Devices → SyncFit lets you add or remove categories at any time. SyncFit only ever asks for read access.

Your first CSV export

  1. Tap the share icon at the top of Home (Quick export) or open the Export tab and choose Create export job.
  2. Under Where should this export go? tap Add destination and pick iCloud Drive or Files. For Files, choose any folder; SyncFit remembers it.
  3. Pick a date range with Choose dates (Today, Yesterday, This week, Last week) or set From and To by hand.
  4. Select metrics. Select all is fine for a first export.
  5. Tap Export. Progress appears at the bottom of the screen; the file lands in iCloud Drive / SyncFit or your chosen folder, named SyncFit_<start>_<end>.csv.

Open the CSV in Numbers, Excel or Google Sheets. Column meanings are listed in the API documentation. CSV to iCloud Drive or Files is included free; JSON and other destinations need Pro or the trial.

Saved export jobs

A job remembers destination, format, metrics and a rolling date range so you can run it again with one tap.

  1. Export tab → Create export job. Give it a name such as “Weekly heart data”.
  2. Choose one destination. The destination decides the output: file destinations show a format picker, databases show Database sync, Calendar shows Calendar events.
  3. Choose the rolling range (last 7 days, last month, since last run) and the metrics.
  4. Leave the mode on Run manually for now and save. Tap Run now whenever you like; dates are recalculated each run.

Tip: use one job per destination. Editing an old multi-destination job asks you to pick a single destination.

Automations and reminders

  1. Open the Automations tab and pick a saved job, or edit the job and change its mode.
  2. Choose Run automatically and a trigger: every few hours, daily, weekly, monthly, when new data arrives, after a workout, or when the app opens.
  3. Optionally turn on completion alerts in Settings → Notifications.

iOS decides when background time is granted, so an automation runs close to, not exactly at, the scheduled time. For best results keep Background App Refresh on for SyncFit and open the app now and then. Prefer control? Choose Remind me instead and SyncFit sends a notification that opens the job for a one-tap manual run.

iCloud Drive and Files

iCloud Drive needs no setup beyond being signed into iCloud with iCloud Drive enabled for SyncFit. Files appear under iCloud Drive / SyncFit. If a file shows as pending, iCloud is still uploading; give it a moment or open the Files app to nudge it.

Files lets you choose any folder the Files app can reach, including On My iPhone and third-party cloud providers that integrate with Files. SyncFit stores a bookmark to that folder and writes there on each run. If the folder moves or the provider signs out, edit the destination and choose the folder again.

PostgreSQL and SQL Server

  1. Create a database user for SyncFit with permission to create a schema and tables. SyncFit writes into the syncfit schema by default; you can change the schema name and add a table prefix.
  2. Export tab → Create export job → Add destination → PostgreSQL or SQL Server. Enter host, port, database, user and password. Keep TLS on verify full when your server has a proper certificate.
  3. Tap Test connection. SyncFit authenticates and creates or migrates its tables. Save becomes available once that succeeds.
  4. Choose metrics, a range and a mode. Database jobs upsert by sample id, so re-running never duplicates rows. Incremental mode sends only new records.

Your phone must be able to reach the server: a public host with TLS, a VPN, or a tunnel. Connection refused, authentication failure and schema errors are reported separately so you know which to fix. Table layouts are documented in the API documentation.

REST API

  1. Stand up an endpoint that accepts POST (or PUT) with a JSON or CSV body and a bearer token. To try it before you have one, run the ten-line local receiver on your Mac. The reference receiver is a small Node service you can run in Docker when you want validation and a database.
  2. Add destination → REST API. Enter the URL (https for anything outside your own network), the method, an optional bearer token and any headers. Set the batch size and timeout if your server has limits.
  3. Save the job with JSON or CSV as the format and run it. SyncFit retries on 429 and 5xx with exponential backoff and reports the final status in History.

Everything about the request, the JSON schema and CSV columns is on the API page.

Email and Calendar

Email sends the export file as an attachment through your own SMTP account. Enter server, port, user, password and recipients when creating the destination. Keep exports small; mail servers typically cap attachments around 20 MB.

Calendar puts workouts and sleep sessions on a calendar you choose. Each event links back to its sample so re-running updates instead of duplicating. Allow Calendar access when iOS asks.

Send data to your Mac

  1. Both devices must use the same Apple ID with iCloud Drive enabled, and Pro must be unlocked.
  2. On iPhone: Settings → Mac sync → turn on Sync with Mac through iCloud, choose how much history to send, then tap Send to Mac now.
  3. On Mac: Home → Refresh from iPhone. The status line reports downloads in progress and how many samples were imported. If files are still downloading, refresh again shortly.

Alternatively point the Mac at the same PostgreSQL or SQL Server database your iPhone exports to (Data source & settings), or open an exported JSON or CSV with Open snapshot.

PDF and HTML reports (Mac)

  1. Open Reports in the Mac sidebar and pick a template: Activity summary, Heart trends, Body progress, Sleep & recovery, Workout log, Nutrition, Mind & stress, or Complete overview. Add or remove metrics with the chips.
  2. Choose the period and whether to compare with the previous period.
  3. Design the document: title, subtitle, prepared-for line, paper size, orientation, chart style, accent colour, and which sections to include (cover, highlights, charts, weekly table, data quality, notes, record table).
  4. Check the live page preview, then Save PDF… or Save HTML…. Finder reveals the file when it is done.

See real output on the samples page.

Storage and deleting data

Settings → Local storage lists export copies kept on the phone and lets you delete individual files, all export copies, or all local app data. Deleting all local data removes saved jobs, connections, credentials, history, imported data and files SyncFit delivered to folders you chose in Files or iCloud Drive. Files already sent to databases or APIs stay where they are. Apple Health itself is never modified.

Unlock Pro on both devices

  1. Buy Pro once on iPhone or Mac. It is a single non-consumable purchase, not a subscription.
  2. On the other device, choose Restore purchases while signed into the same Apple ID.
  3. Optionally sign in with the same SyncFit account (Sign in with Apple) on both devices; it stores only the purchase state and unlocks the Mac automatically.

Refunds are handled by Apple at reportaproblem.apple.com.