RambleRamble

Receive your transcripts

Once a note is transcribed, your iPhone POSTs the transcript to your destination: an automation platform, an agent, or your own backend. Three steps to set it up. Webhooks work alongside the agent connection; use either or both. Which one fits.

1

Add a destination

In Ramble on your iPhone, open Settings → Webhook and tap Add destination. Paste in an HTTPS URL from your automation platform (step 2) or your own server. Ramble sends to one destination, and you can change it any time with Edit destination.

The URL must use HTTPS. Localhost, private and link-local addresses, and .internal hosts are refused.

2

Point it somewhere

Use an automation platform

Create a webhook trigger, copy the URL, paste it into Ramble.

Notion and IFTTT don't accept incoming webhooks directly — use Zapier or Make as a bridge.

Or build your own endpoint

Point Ramble at any HTTPS URL you control. Once your iPhone has a note's transcript, it sends one POST with Content-Type: application/json. Return any 2xx within 10 seconds. Otherwise Ramble tries 3 times in total, 30 seconds and then 2 minutes apart, and marks the note “Didn't send”; tapping Retry starts 3 fresh attempts. Pending webhooks survive the app closing and wait while the iPhone is locked.

Webhooks go straight from the iPhone to your URL. Ramble's server never sees the URL or the secret. A watch note is sent once the iPhone pulls its transcript. Notes with no speech are not sent.

Payload

json
{
  "recording_id": "550e8400-e29b-41d4-a716-446655440000",
  "created_at": "2026-03-17T13:19:00Z",
  "duration": 138.5,
  "transcription": "Just had a great idea for the landing page...",
  "device_id": "7a2b3c4d-5e6f-7890-abcd-ef1234567890"
}
recording_idstring

UUID v4. Unique identifier for this recording.

created_atstring

When recording started, ISO 8601 in UTC.

durationnumber

Recording length in seconds.

transcriptionstring

Full transcript text.

device_idstring

A random ID for this install of Ramble. Not tied to any account.

Verify the signature

Every request includes an X-Webhook-Signature header — an HMAC-SHA256 digest of the raw request body, keyed with the signing secret, as sha256=<hex>. Reveal and copy the secret under Settings → Webhook → Edit destination. Always verify before processing to confirm the request came from Ramble.

verify.js
const crypto = require("crypto");

function verifySignature(rawBody, signatureHeader, secret) {
  const hmac = crypto.createHmac("sha256", secret);
  hmac.update(rawBody);
  const expected = "sha256=" + hmac.digest("hex");

  return crypto.timingSafeEqual(
    Buffer.from(expected),
    Buffer.from(signatureHeader)
  );
}

If you tap Regenerate, your endpoint needs the new secret to accept requests.

Full Express server example
server.js
const express = require("express");
const crypto = require("crypto");

const app = express();
const WEBHOOK_SECRET = process.env.RAMBLE_WEBHOOK_SECRET;

app.post(
  "/webhook",
  express.raw({ type: "application/json" }),
  (req, res) => {
    const signature = req.headers["x-webhook-signature"];
    if (!signature) {
      return res.status(401).json({ error: "Missing signature" });
    }

    const hmac = crypto.createHmac("sha256", WEBHOOK_SECRET);
    hmac.update(req.body);
    const expected = "sha256=" + hmac.digest("hex");

    if (
      !crypto.timingSafeEqual(
        Buffer.from(expected),
        Buffer.from(signature)
      )
    ) {
      return res.status(401).json({ error: "Invalid signature" });
    }

    const payload = JSON.parse(req.body);
    console.log("Transcription:", payload.transcription);

    res.status(200).json({ ok: true });
  }
);

app.listen(3000, () => console.log("Listening on :3000"));
3

Test it

Open the destination from Settings → Webhook and tap Send test webhook. Ramble shows “Test delivered” or the reason it failed. The test payload has the same shape as a real one, with test set to true, a recording_id starting with test-, and duration 0.

json
{
  "recording_id": "test-550e8400-...",
  "created_at": "2026-04-09T12:00:00Z",
  "duration": 0,
  "transcription": "This is a test webhook from Ramble.",
  "device_id": "7a2b3c4d-...",
  "test": true
}

If the test succeeds, you're all set: every new transcript is sent on its own. If it fails, check that your endpoint returns a 2xx and that the URL is correct.