# Configure a Veura webhook

Add an HTTPS endpoint, filter completed transcriptions by source, include audio optionally, test delivery, and review history.

Updated: 2026-11-11
Canonical: https://veura.app/guides/webhooks/setup

A webhook lets a completed transcription start a workflow you control. Veura sends directly from the iPhone to the HTTPS endpoint you configure.

## Prepare the endpoint

- Use a valid public HTTPS URL. HTTP and URLs with embedded credentials are rejected.
- Accept POST requests with JSON, or multipart form data when audio is enabled.
- Return a 2xx response after the event has been accepted.
- Store and deduplicate by X-Veura-Event-ID before running side effects.
- Choose a signing secret if the endpoint should verify HMAC-SHA256 signatures.

## Add the endpoint in Veura

1. **Open Settings.** Choose Webhooks in the Connected section.
2. **Tap Add.** Give the endpoint a recognizable name and enter its HTTPS URL.
3. **Choose sources.** Select Microphone, Imported Audio, Index 01, or Legacy / Unknown.
4. **Choose optional content.** Enable audio only if the destination is prepared to receive multipart data.
5. **Add a signing secret.** The secret is optional and is stored in the iOS Keychain on this device.
6. **Save.** A saved endpoint can send a test and exposes its delivery history.

![Veura New Webhook screen with endpoint, source, audio, and Index Assistant filters](https://veura.app/screenshots/current/raw/webhook-editor.png)

Each endpoint has its own source filters, Assistant policy, audio setting, and optional signing secret.

## Decide how to handle Assistant requests

Assistant requests are excluded by default. The Include Assistant requests control becomes available when Index 01 is selected as a source. If enabled, the webhook receives the transcribed question before Veura generates the Assistant answer; the answer itself is not included.

## Send a test

Open the saved endpoint and choose Send Test to Saved Endpoint. The test uses kind test, a generated event ID, source Legacy / Unknown, model test, and the text “This is a test delivery from Veura.”

> **A test uses the saved configuration.** Save URL or secret changes before testing. A failed test follows the same delivery machinery and may be queued for retry when the failure is retryable.

## Privacy boundary

Enabling a webhook automatically sends selected transcript text and metadata off the iPhone. Audio leaves the device only when Include audio file is enabled. The endpoint operator controls its own storage, security, and retention after receipt.
