Apple Reminders Import

LifeOS provides a POST endpoint at /api/todos/import that accepts todos from Apple Reminders. This is designed to work with an Apple Shortcut that runs on your Mac and sends reminders to your LifeOS instance.

The endpoint requires an API key passed in the request headers:

POST /api/todos/import
Authorization: Bearer your-todos-import-key
Content-Type: application/json

The key must match the TODOS_IMPORT_KEY environment variable set in Vercel.

Send an array of reminder objects:

{
  "reminders": [
    {
      "title": "Buy groceries",
      "apple_reminder_id": "x-apple-reminder://ABC123",
      "due_date": "2024-01-15",
      "notes": "Optional notes field"
    }
  ]
}

Each reminder must include a title and apple_reminder_id. The due_date and notes fields are optional.

The endpoint uses the apple_reminder_id field to prevent duplicate imports. If a todo with the same apple_reminder_id already exists in the database, it is skipped. This means you can run the import shortcut repeatedly without creating duplicates.