Cloud Inbox

Cloud Inbox lets you append tasks to a database's Inbox from anywhere through a simple HTTP API. It is useful for scripts, automations, and integrations that need to push tasks into HamsterBase Tasks without opening the app.

Please read before using

• Cloud Inbox is a paid feature. It is included in the Pro and Lifetime plans. See the pricing section for details.
• Inbox content is stored unencrypted on the server. Unlike the rest of your data, which is end-to-end encrypted, the title and notes you send through Cloud Inbox are kept in plain text on the server until they are pulled into your database. Do not send sensitive or private information through Cloud Inbox.

Creating a Token

A token authorizes appending tasks into one specific database's Inbox. Each token is tied to a single database.

1. Open the Settings page.
2. Go to the Sync tab.
3. Under Database, find the database you want to deliver tasks to. Tasks will be appended to this database's Inbox.
4. Click the button to enable Cloud Inbox for that database. A token is created.
5. Click Copy to copy the token to your clipboard.

The token looks like this:

tk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

WARNING

Keep this token secret. Anyone who has it can append tasks to your database's Inbox.

Appending a Task

Send a POST request to the append endpoint with the token in the Authorization header.

• Endpoint: https://cloud.hamsterbase.com/api/tasks/inbox/v1/append
• Method: POST
• Headers: Content-Type: application/json, Authorization: Bearer <token>
• Body: { "title": "<title>", "notes": "<notes>", "due_date": <due_date> }

Field	Type	Required	Description
title	string	Yes	The task title.
notes	string | null	No	The task notes.
due_date	number | null	No	The due date as a Unix timestamp in milliseconds, set to UTC midnight of the target day. Omit or set to null for no due date.

Computing due_date

The due date is a whole calendar day anchored at UTC midnight. Use Date.UTC(year, month - 1, day) (note the month is 0-based). For example, 2026-05-20 is Date.UTC(2026, 4, 20) = 1779235200000.

Example: curl

curl -X POST https://cloud.hamsterbase.com/api/tasks/inbox/v1/append \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer tk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -d '{"title":"Buy milk","notes":"From the store on the way home","due_date":1779235200000}'

On success the endpoint returns HTTP 200. The task will show up in the selected database's Inbox after it syncs.