> ## Documentation Index
> Fetch the complete documentation index at: https://docs.augmental.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Send your notes to another app with a webhook

> Vox sends each new, edited or deleted note to an address you choose.

When you save, edit or delete a note, Vox sends it to the address. Use it to put notes in Notion, Slack, a task app or your own server.

Dictation is not sent. It stays on your device.

## Add a webhook

**1. Get an address**

In Zapier, Make or n8n, make a webhook trigger and copy its address. It starts with `https://`.

**2. Add it in Vox**

**Settings › Account › Connected apps**, tap **+**, then **Webhook**. Paste the address.

**3. Choose notes**

Leave **All notes** on, or turn it off and pick labels. Tap **Add**.

**4. Test it**

Tap **Send test**. Vox sends a sample note, and your app learns its fields.

You can have up to 5 webhooks.

## Send to Slack

Paste a Slack incoming webhook address (it starts with `https://hooks.slack.com/services/`). Vox posts each note as a message in that channel: its text, then "Label:" and its label, with the title on longer notes. An edit posts again, starting with "Edited:"; a delete posts "Note deleted." Pinning or relabeling a note posts nothing. **Send test** posts a test message.

To get an address: in Slack, create an app with **Incoming Webhooks** turned on, pick a channel, and copy the webhook URL.

## What Vox sends

Every other address gets a `POST` with the note as JSON:

```json theme={null}
{
  "type": "note.created",
  "timestamp": "2026-11-07T10:15:00Z",
  "data": {
    "id": "…",
    "title": "Pricing idea",
    "text": "…",
    "formatted_text": "…",
    "label": { "id": "…", "name": "Work" },
    "pinned": false,
    "captured_at": "…",
    "created_at": "…",
    "updated_at": "…",
    "url": "vox://note/…"
  }
}
```

`type` is `note.created`, `note.updated`, `note.deleted` or `webhook.test`. A deleted note sends only its `id`. Order is not promised: use `updated_at`.

## Check that it came from Vox

Requests follow [Standard Webhooks](https://www.standardwebhooks.com/). Copy the secret from the webhook's page, then check each request with their library:

```js theme={null}
import { Webhook } from "standardwebhooks";

const wh = new Webhook(process.env.VOX_WEBHOOK_SECRET); // whsec_…
const event = wh.verify(rawBody, request.headers); // throws if not from Vox
```

**New secret** ends the old one right away.

## When sends fail

Vox retries for about a day and a half. If every send fails for 3 days, Vox turns the webhook off and says so on its page. Fix your server, tap **Send test**, then **Turn on**. Notes saved while it was off are not sent.

## Remove a webhook

Open it in **Connected apps**, then tap **Delete webhook**.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.