Courier
中文

Guides

How to connect each destination, and the things that trip people up.

When does Courier update?

iOS does not let any app read Health data while the iPhone is locked. Courier catches up in three ways: after your sleep is recorded and you unlock the phone, once or twice a day in the background, and every time you open the app. Background wake-ups are scheduled by iOS and are not guaranteed, and swiping the app away stops them. Opening Courier always fills in the recent days.

Catch-up range and history Pro

By default Courier catches up the last 7 days. With Pro you can choose 14 or 30 days under Destinations › Health access & data, and use History initialization to send older data to a destination once, month by month. It pauses while the phone is locked and continues when you return.

Free plan: one destination besides the on-device folder. Today is written after it ends; each sync fills in the last 7 finished days.

On-device folder Free

What you need

  • No account and no setup.

Steps

  1. Once Courier can read Health data, it starts writing automatically.
  2. Open the Files app › On My iPhone › Courier. health-daily.csv is your data, one row per day.
  3. Open it in Numbers or Excel.

Watch out for

  • Deleting Courier deletes this folder too. To keep your data long term, also add a Folder destination (for example a folder in iCloud Drive), or copy the file out now and then.
  • Don't edit the header row, or writing stops. You can add your own columns on the far right; Courier leaves them alone.
  • The on-device folder doesn't count toward the free destination limit.

Folder (iCloud Drive and others) Free

What you need

  • For iCloud Drive: turn on Settings › Apple Account › iCloud › iCloud Drive › Sync this iPhone first.

Steps

  1. In Courier open Destinations › Add destination › Folder.
  2. Pick a folder in the system picker (for example a new “Health” folder in iCloud Drive) and tap Open.
  3. Courier writes health-daily.csv into it, one row per day.

Watch out for

  • Uses the one free destination slot (the on-device folder doesn't count). Disconnect it here before adding a different destination.
  • If the folder is moved, renamed or deleted, writing fails and the app tells you. Tap Choose folder again.
  • Don't edit the header row; add your own columns on the far right.
  • iCloud syncs to your other devices on its own schedule, so the file may take a while to appear there.
  • Courier only reads and writes health-daily.csv in that folder. Disconnecting doesn't delete files already written.

Export CSV Free

What you need

  • Nothing.

Steps

  1. In Courier open Destinations › Export CSV.
  2. Choose a date range and share the file with AirDrop, Mail or Save to Files.

Watch out for

  • Free exports cover the last 30 days; Pro has no limit.
  • Only finished days are exported, up to yesterday.
  • The file is UTF-8 and opens correctly in Excel. Cells without data are left empty.

Google Sheets Free

What you need

  • A Google account.

Steps

  1. In Courier open Destinations › Add destination › Google Sheets.
  2. Sign in with Google and allow access. Courier creates a spreadsheet called “Courier” in your Drive.
  3. The last 7 finished days are written automatically, one row per day. Today is written after it ends.

Watch out for

  • Uses the one free destination slot.
  • Don't edit the header row or delete Courier's columns. Add your own columns on the far right; Courier leaves them alone.
  • “Data status” and “Updated at” always stay last among Courier's columns; metrics you turn on later are inserted before them.
  • Syncing the same day again overwrites its row; there are no duplicates.

Notion Free

What you need

  • A Notion account and a new, empty database (a full-page database, not one embedded in another page).
  • It's easiest to do the Notion part on a computer and then move the secret and link to your iPhone.

Steps

  1. In Notion open Settings › Developer tools › Connections, choose “+ New connection”, name it Courier, and copy its secret (API token).
  2. Open your database, choose ••• in the top-right corner of the page › Connections, type Courier in the search box, and add it.
  3. From the same ••• menu choose Copy link to get the database link.
  4. Move the secret and link to your iPhone (Notes works). In Courier open Destinations › Add destination › Notion, paste both and tap Verify and save.
  5. Go back to Today and tap refresh. The database shows the last 7 days, one row per day, with the date in the title column and properties such as Steps and Sleep created for you.

Watch out for

  • Courier isn't listed under Connections: new connections aren't listed until you type the name in the search box. Use the ••• in the top-right corner of the page, not the one next to the table view. Still missing? Check that you're in the workspace where you created the connection, or add the connection on the parent page.
  • Use the link of the database itself: if the database is embedded in a page, click its name to open it as a full page first, then copy the link. The outer page's link won't work.
  • Use a new, empty database: an existing property with the same name but a different type causes an error, and Courier can't reorder properties that already exist.
  • Uses the one free destination slot. Disconnect any other destination first.
  • Paste the secret only into Courier on your iPhone; it's kept in the Keychain. If you used Notes to move it, delete that note afterwards.

Feishu / Lark Free

What you need

  • A Feishu (or Lark) account that can create apps on the Open Platform.
  • It's easiest to do this on a computer and then move the App ID, App Secret and link to your iPhone.

Steps

  1. Open the Open Platform (open.feishu.cn for Feishu, open.larksuite.com for Lark), go to the Developer Console and create a custom app, for example named Courier.
  2. Find the App ID and App Secret under Credentials & Basic Info.
  3. Under Permissions, search for Bitable and turn on “View, comment, edit and manage Bitable”.
  4. Under Version Management & Release, create a version and publish it (approve it yourself if you're the admin).
  5. Create a new, empty Bitable in Docs.
  6. In the Bitable choose ••• › More › Add document app, search for Courier and give it edit access.
  7. Copy the link from the browser's address bar. It looks like https://xxx.feishu.cn/base/…?table=tbl….
  8. In Courier open Destinations › Add destination › Feishu, choose Feishu or Lark, enter the App ID, App Secret and link, and tap Verify and save.
  9. Go back to Today and tap refresh. The table shows the last 7 days, one row per day, with the date in the first column.

Watch out for

  • “Add document app” is under More, the second-to-last item in the ••• menu.
  • Your app doesn't show up: check that it's published, has the Bitable permission, and that you're within its availability range. After changing permissions, publish a new version for them to take effect.
  • Create the Bitable directly in Docs, not inside a Wiki. Wiki links don't contain /base/, so Courier can't read them.
  • The link must contain table=.
  • Give the app edit access; read-only access can't write.
  • Uses the one free destination slot.
  • Paste the App Secret only into Courier on your iPhone; it's kept in the Keychain. Delete any note you used to move it.

Markdown notes Free

What you need

  • An Obsidian vault, in iCloud Drive or On My iPhone.

Steps

  1. In Courier open Destinations › Add destination › Markdown notes.
  2. Pick your Obsidian vault, or a subfolder you use for daily notes.
  3. Courier writes one YYYY-MM-DD.md per day and puts the metrics in the note's properties.

Watch out for

  • Your own properties and the note body are never changed. Syncing the same day again only updates Courier's properties.
  • If the folder already has a YYYY-MM-DD.md for that day (your daily note, for example), Courier merges its properties into it instead of creating a second file.
  • Uses the one free destination slot.

Shortcuts Pro

What you need

  • Pro.

Steps

  1. Open the Shortcuts app, create a shortcut and search for Courier.
  2. Add “Get health summary”. It returns JSON text for yesterday or the last 7 days.
  3. Send the result to Notes, Reminders, Notion or a web request. “Sync now” asks Courier to catch up right away.

Watch out for

  • Runs on your iPhone only, without the network. Metrics without data are left out.
  • Without Pro the actions say Pro is required and return no data.

Webhook Pro

What you need

  • Pro.
  • Your own https endpoint.

Steps

  1. In Courier open Destinations › Add destination › Webhook and enter the address.
  2. Tap Save and generate signing secret, copy the secret right away and add it to your receiver.
  3. Tap Send a test to post one sample record marked is_test with fake values.
  4. After that, each finished day is sent as a JSON POST.

Watch out for

  • The secret is shown only once. You can generate a new one, but the old one stops working immediately and your receiver must be updated.
  • Only https addresses are supported.
  • Each request carries X-PDB-Signature: sha256=HMAC-SHA256(secret, raw body) for verification and a stable X-PDB-Delivery id for de-duplication.
  • A missing key means “not collected”; null means “collected, no data”.
  • Failed deliveries are retried automatically.

Files for AI Pro

What you need

  • Pro.
  • A folder destination (the on-device folder, or an added Folder).

Steps

  1. Turn on Files for AI under Destinations.
  2. Courier writes two files next to your CSV: courier-data-dictionary.md (what each column means) and courier-summary.md (7-day and 30-day summaries).
  3. Give these files and the CSV to any AI.

Watch out for

  • Files only: no network, and no AI is called.
  • Turning it off keeps the existing files but stops updating them.