Webhook

Push data from any service — no limits on what you can connect

Overview

The Webhook integration is a universal bridge that lets you push data from any source directly into deariary. Generate a bearer token, then have any service, device, or script POST JSON data to our endpoint. Each payload is stored and automatically included in your next diary generation. There is no fixed schema — send whatever data makes sense for your use case.

Use cases

A micro-diary CLI tool that lets you jot down quick notes from the terminal throughout the day
A custom mobile app or iOS Shortcut that captures thoughts, photos descriptions, or voice memo transcripts on the go
A "save for later" app or browser extension that sends bookmarked articles and highlights to your diary
Smart pet devices — log your cat's litter box visits and weight changes from a Petkit or Litter-Robot
A personal finance script that fetches your daily portfolio snapshot from a brokerage API

Data collected

Free-form JSON — any valid JSON payload (max 100 KB per request)
Source label — the token name you defined, attached to each payload
Multiple ingests per day — each POST creates a separate artifact, all included in the next diary generation

There is no fixed schema — send whatever JSON makes sense for your use case. Each payload is stored and included in the next diary generation.

Sample diary excerpt

March 12, 2026

Quick notes

Jotted down 3 notes from the terminal today. The best one: "API design should feel like a conversation, not a contract." Also captured a voice memo on the train about the podcast episode on urban farming.

Reading

Saved 2 articles via the browser extension — one on WebAssembly outside the browser, another comparing edge compute providers. Highlighted a passage about cold starts.

Mochi (cat)

Mochi used the litter box 3 times today — all normal. Weight steady at 4.2 kg from the Petkit scale. She demolished the new feather toy in under an hour.

Portfolio

Sold AAPL at +3.2% and opened a small position in MSFT. Portfolio is up 1.4% for the week.

A day of small captures adding up. Mochi is doing well. Market had a good day too.

Setup

Create a webhook token from the Webhook settings page. Send a POST request with your token as a Bearer token in the Authorization header. The request body should be valid JSON (max 100 KB). Any structure is accepted. Data is stored and included in the next diary generation for that day.

Endpoint: POST /webhooks/ingest Authorization: Bearer whk_your_token_here

Requires the Advanced plan. You can create up to 10 tokens.

Permissions

No OAuth required. Authentication uses a Bearer token generated in the deariary Webhook settings page. Each token is prefixed with whk_.

Plan

Requires the Advanced plan. Up to 10 tokens per account.