# Rumorly

> Turn "how did you hear about us?" answers into channels, named sources and revenue.

- [Introduction](https://docs.rumorly.io/index.md): Rumorly reads every "how did you hear about us?" answer, names the source behind it and puts your revenue next to it.
- [Quickstart](https://docs.rumorly.io/quickstart.md): From signup to a revenue-by-channel report in about five minutes.
- [Concepts](https://docs.rumorly.io/concepts.md): Channels, named sources, the review queue, confidence and how revenue is matched.
- [JS snippet](https://docs.rumorly.io/collect/snippet.md): Ask the question inside your product with a 4 kB script.
- [REST API](https://docs.rumorly.io/collect/rest-api.md): Send answers from your server with a secret key.
- [CSV import and Paste answers](https://docs.rumorly.io/collect/csv-and-paste.md): Bring in answers you already have, on any plan, including Free.
- [Tally](https://docs.rumorly.io/collect/tally.md): Send Tally form submissions to Rumorly with a webhook.
- [Generic webhooks](https://docs.rumorly.io/collect/webhooks.md): Typeform, Webflow, Framer, Zapier and anything else that can POST.
- [Attio](https://docs.rumorly.io/integrations/attio.md): Import existing answers from Attio and write the classification back.
- [Stripe](https://docs.rumorly.io/integrations/stripe.md): Read subscriptions with a restricted key and put revenue next to every channel.
- [Reading the report](https://docs.rumorly.io/reports/reading-reports.md): Revenue by what customers said, next to what click data credited.
- [Weekly digest](https://docs.rumorly.io/reports/weekly-digest.md): A Monday email with what changed in where customers hear about you.
- [CSV export](https://docs.rumorly.io/reports/csv-export.md): Take the report into a spreadsheet.
- [Plans and limits](https://docs.rumorly.io/account/plans.md): What each plan includes, the signup trial and what happens at a limit.
- [Data and privacy](https://docs.rumorly.io/account/privacy.md): What Rumorly stores, what it sends to the AI model and how to erase a person.
- [Overview](https://docs.rumorly.io/api-reference/overview.md): Base URL, authentication, idempotency, pagination and errors.
- [Check a key](https://docs.rumorly.io/api-reference/basics/check-a-key.md): Returns 200 with your workspace id when the key is valid.
- [Record an answer](https://docs.rumorly.io/api-reference/responses/record-an-answer.md): Stores a "how did you hear about us?" answer and classifies it in the background. Send an `Idempotency-Key` header so retries never create duplicates. Works with a secret key from your server or a publishable key from the browser.
- [List responses](https://docs.rumorly.io/api-reference/responses/list-responses.md): Newest first, cursor-paginated. Use `updated_since` to sync changes into your own systems.
- [Get a response](https://docs.rumorly.io/api-reference/responses/get-a-response.md): One answer with its classification, the person who gave it and their monthly revenue.
- [Correct a classification](https://docs.rumorly.io/api-reference/responses/correct-a-classification.md): Overrides the channel and, optionally, the named source. Send `entity_id` to link an existing entry (or `null` to clear it), or `entity_name` to create/approve one by name; omit both to keep the current entity. Overrides are kept as labelled examples, and automatic classification never overwrites th…
- [Erase a person](https://docs.rumorly.io/api-reference/people/erase-a-person.md): GDPR erasure. Deletes the person, their answers, classifications and billing matches, and queues blanking the Rumorly attributes in Attio. Pass `email` or `external_id`. Erasure works on every plan.
- [Revenue by channel](https://docs.rumorly.io/api-reference/reports/revenue-by-channel.md): Monthly recurring revenue of matched customers, grouped by the channel (or named entity) they said they heard about you from, next to what first-touch/UTM data says.
- [One channel in detail](https://docs.rumorly.io/api-reference/reports/one-channel-in-detail.md): The named sources inside one channel, its monthly trend and the newest answers.
- [Export as CSV](https://docs.rumorly.io/api-reference/reports/export-as-csv.md): The revenue-by-channel report as a CSV file (money in major units, e.g. `1900.00`).
- [Snippet settings](https://docs.rumorly.io/api-reference/snippet/snippet-settings.md): What the JS snippet shows: your question and up to six quick-pick answers, ordered by your most-answered channels. Called by the snippet with a publishable key from an allow-listed origin.

## OpenAPI Specs

- [openapi](/openapi.json)


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