Webhooks

Get notified when articles are added, filed, or read. Trigger your own workflows.

Overview

Webhooks let you react to events in Grove. When something happens (article clipped, filed, read), Grove sends a POST request to a URL you register.

Status: Coming soon — webhooks are on the active roadmap.

Planned Events

- `article.created` — New article clipped to queue

- `article.filed` — Article saved to vault (Library or folder)

- `article.read` — Article marked as read

- `article.deleted` — Article removed

Register a Webhook

POST /api/webhooks
{
  "url": "https://your-agent.example.com/hook",
  "events": ["article.created", "article.filed"],
  "vaultPath": "Research/AI"  // optional: filter by folder
}

Use Cases

- Article filed to `Research/AI` → agent summarizes and cross-references your vault

- New article clipped → agent enriches metadata, suggests tags

- Article marked read → trigger Obsidian sync or send to Readwise