# Revnu Docs > How to use Revnu, plus the API, CLI and MCP server. GTM on autopilot. Revnu (revnu.com) runs your pipeline, ads and GEO. The founder pages cover setup, what Revnu asks before it acts, what your results mean, billing and troubleshooting. The developer pages cover the API, CLI and MCP server: read your review queue, approve or decline cards, message Revnu and pull results into your own software. Revnu's website is revnu.com; older addresses such as revnu.app and revnu.dev are retired and are not a separate product. Last updated 2026-10-22. Every page below is available as markdown at the linked `.md` URL, or by requesting the HTML URL with `Accept: text/markdown`. The introduction lives at /docs itself; its markdown twin is /docs/introduction.md. - OpenAPI 3.1 description of every route: https://revnu.com/openapi.json - Remote MCP server: https://revnu.com/api/mcp (OAuth; setup at https://revnu.com/docs/mcp.md) - Docs MCP server, no sign-in: https://revnu.com/api/docs-mcp (search and read these docs) - Search the docs: https://revnu.com/docs.md?q=your+words returns ranked results as markdown; https://revnu.com/docs?q=your+words opens the same search in a browser - Every docs page in one file: https://revnu.com/docs/llms-full.txt - Everything on revnu.com (docs, blog, guides) in one file: https://revnu.com/llms-full.txt ## Get Started - [Revnu Docs](https://revnu.com/docs/introduction.md): How to use Revnu to get customers, from your first day to your first report, plus the API, CLI and MCP server for developers. - [Get Started With Revnu](https://revnu.com/docs/get-started.md): Sign up, check what Revnu learned from your website, pick Slack, iMessage or the dashboard, and get Revnu's first plan. Works on a phone, inside Facebook or Instagram, and without Slack or an iPhone. - [Your First Day With Revnu](https://revnu.com/docs/first-day.md): Your three jobs on day one, where your first message goes, what to do when the first plan is wrong, when the first emails really leave, why Revnu may ask for a card first, and how to start with ads, one country or no blog. - [What Revnu Does on Its Own Each Day, and What Waits for You](https://revnu.com/docs/what-revnu-does-each-day.md): How Revnu works day to day. What it does on its own every day, what always waits for your yes, what your approval settings decide, when it messages you, and how to hand it more of the work. - [What Revnu Can Do, and Who It Fits](https://revnu.com/docs/what-revnu-can-do.md): Who Revnu fits best, how it grows apps, events and low-priced products, and how it handles every channel, from cold email and LinkedIn to ads, SEO and AI answers. Covers apps, events, app installs, display ads, landing pages, analytics tools, Pinterest, Reddit replies, Wix, TikTok and agencies. - [Integrations: What Revnu Connects To](https://revnu.com/docs/integrations.md): Every tool Revnu connects to and where you connect it, starting with an I want to… table. Plus what it doesn't connect to yet, including CRMs, CSV export, Zapier, PostHog, Mixpanel, Google Analytics and headless CMSs. - [Security, Privacy and Your Data](https://revnu.com/docs/security-and-data.md): Who sees your chat messages, which AI companies process them, Revnu's compliance status (DPA, subprocessors, SSO, SOC 2), what it stores and where, how it uses your mailbox and LinkedIn, what to send your security or procurement team, and how to get your data deleted. - [Can an Agency Use Revnu for Clients?](https://revnu.com/docs/agencies.md): Yes, as one separate Revnu account per client. There's no white label and no multi-client console. Which ad channels each client account covers, how budgets, pausing and approvals work per client, a suggested one-client pilot, and who to talk to about large budgets. ## Connect Your Channels - [Talk to Revnu in Slack, iMessage or the Dashboard](https://revnu.com/docs/talk-to-revnu.md): Talk to Revnu in Slack, iMessage or the dashboard chat. WhatsApp, SMS and email aren't ways to talk to Revnu. Where updates arrive, approving from your phone, files, other languages, and sending several requests. - [Add Revnu to Slack](https://revnu.com/docs/connect-slack.md): Install the Revnu Slack app, type /invite @Revnu in your channel, paste the code if the screen shows one, use a Slack Connect channel on Managed, and fix no hello, an admin block or Revnu leaving. - [Text Revnu on iMessage](https://revnu.com/docs/text-revnu.md): Revnu's iMessage number, why it texts you and how to stop it, who sees your messages, how to connect from any country, what to do if your iPhone texts from an Apple ID email, and who that unknown +1 415 number is. - [Connect Gmail or Outlook to Send Email](https://revnu.com/docs/connect-email.md): Connect a Gmail, Google Workspace, Outlook or Microsoft 365 mailbox so Revnu can send your outreach and read replies. Which providers work, what to do when Microsoft 365 asks for an admin or IT blocks it, which address to use, and where your sent mail shows up. - [Connect Notion, Granola or Circleback to Revnu](https://revnu.com/docs/connect-notion.md): How to connect Notion, Granola or Circleback in Connections > Learn Your Business, how to choose which Notion pages Revnu can read, what to ask once it's connected, and what Revnu can and can't do with your docs and meeting notes. - [Connect Google Ads](https://revnu.com/docs/connect-google-ads.md): Connect your Google Ads account so Revnu can build Search, Performance Max and Demand Gen campaigns for your approval. What access you give, and what to do when no ad account shows up. - [Connect LinkedIn](https://revnu.com/docs/connect-linkedin.md): Connect your LinkedIn so Revnu can send connection requests and messages as you, slowly and in working hours, and read your replies. What it does with your account, how fast, connecting on a phone, teammates' accounts, and read-only mode. - [Connect Microsoft Ads](https://revnu.com/docs/connect-microsoft-ads.md): Connect Microsoft Advertising (Bing) so Revnu can build Search campaigns for your approval. What Revnu builds on Microsoft, what it doesn't, and what to do when no ad account shows up. - [Connect LinkedIn Ads](https://revnu.com/docs/connect-linkedin-ads.md): Connect LinkedIn Campaign Manager so Revnu can build image ads that post as your company page. Why the person who connects must be an admin of that page, what "image access" or "page access" means, and how to pick the right ad account. - [Connect Reddit Ads](https://revnu.com/docs/connect-reddit-ads.md): Go from no Reddit ad account to your first live Reddit tests. The steps only you can do in Reddit Ads, the steps Revnu does after you connect, and what to do when Reddit says no ad account or the payment method isn't approved. - [Connect TikTok Ads](https://revnu.com/docs/connect-tiktok-ads.md): Connect TikTok Ads Manager so Revnu can run your own videos or creators' posts as Spark Ads. Which TikTok login to use, what Spark Ads need, the USD 20 a day minimum, and what to do when no ad account was shared. - [Connect X Ads](https://revnu.com/docs/connect-x-ads.md): Connect your X (Twitter) Ads account so Revnu can build image ads for your approval. Which X login to use, why Revnu can't see an account until billing is active, and the X Pixel you create once. ## Working With Revnu - [What Revnu Asks Before It Acts](https://revnu.com/docs/approvals.md): Your first sequence always waits for your yes, and approving it once gets daily outreach going. The six approval settings in Settings > Agent, the Pro defaults, what always waits, when Revnu asks again, what switching to Just Do It does to cards already waiting, and how to hand over routine sending. - [The Review Screen: Every Card and Button](https://revnu.com/docs/review-screen.md): What each card in Review means and whether Approve sends straight away, why there's no approve-all and the fastest way through a pile of cards, what site fix cards do, where list results go, how long cards wait, where your past decisions are, and how to approve from your phone. - [Teach Revnu Your Business With Memory](https://revnu.com/docs/memory.md): How to give Revnu your business context once in Settings > Memory. What goes in your About file, Who We Sell To, Product Facts and Never Say, how to keep Revnu on brand with a voice brief and approval on everything, how to handle several locations or offers, how to update Who We Sell To from your own documents, the Change a Rule card, which rules are checked and which are followed, and how to make corrections stick. - [Add Teammates](https://revnu.com/docs/teammates.md): How to add a teammate in Settings > Account > Team, the invite email they get and how they sign in (Google or an emailed code), how to scope a trial to one channel, where roles stand, how to have Revnu message a teammate for you, what each person's chat shows, why a shared Slack channel mixes requests, and how to keep work apart. - [Recurring Work With Workflows](https://revnu.com/docs/recurring-work.md): Put your growth on autopilot with Workflows. Describe the work once, such as fresh leads every Monday or a blog post every weekday, and Revnu runs it on schedule. - [Pause or Stop Everything](https://revnu.com/docs/pause-revnu.md): Say "pause" and Revnu cancels queued email, sequence and one-off alike, and makes everything ask first. A checklist to stop absolutely everything, how to train Revnu before anything sends, what it doesn't stop (live ads), how to see what already went out, how to resume, and the difference between pausing and cancelling your plan. - [Changed What You Sell? Get Revnu Pitching the New Thing](https://revnu.com/docs/changed-what-you-sell.md): What to do when you pivot, change your offer or retire a product. Rewrite Memory, put the old pitch on Never Say, stop or rewrite the old sequences, update the AI visibility questions you track, fix live posts, and what to check when Revnu still pitches the old thing. ## Outreach & Social - [How Revnu Finds Leads](https://revnu.com/docs/find-leads.md): How Revnu finds buyers, how to ask for leads and describe a narrow buyer, keep a list to one region, build lists of investors, partners or affiliates, turn a directory or event list into leads, and whether it uses your LinkedIn. Revnu finds businesses, not consumers. - [Import Your Own List of Leads](https://revnu.com/docs/import-leads.md): Bring your own list into Revnu by uploading a CSV or Excel file in chat, keep extra columns such as a discount code for each lead, add contacts you already have, correct a lead's details, and get a list of your leads back out. - [What's on a Lead: Why Now, Sources and Updating Lead Info](https://revnu.com/docs/lead-details.md): What a lead on the Leads page shows (the Why Now, its source links, the fit score, its campaign and its draft), how to update a lead's info or tell Revnu something it should know, what Relationship Route means, and where a directory or event list lands. - [Sequences: Steps, Follow-Ups and Approval](https://revnu.com/docs/sequences.md): Where your email sequences live on Leads, how steps, follow-ups and waits work, what the fields in your copy mean, what one approval covers and when Revnu asks again, who the emails come from, and how to make them sound like you. - [How Revnu Keeps Your Emails Out of Spam](https://revnu.com/docs/deliverability.md): How Revnu lands your emails in the inbox and protects your domain. It builds and warms up dedicated sending inboxes, paces every mailbox with smart limits, checks every address before it sends, and pauses a mailbox the moment anything looks off. - [Sending Inboxes Revnu Buys and Warms Up](https://revnu.com/docs/sending-inboxes.md): Why Revnu proposes lookalike domains and sending inboxes, who pays for them, what you approve, how long they take to warm up, how many emails they send and how to check their progress. - [How Many Emails Revnu Sends a Day](https://revnu.com/docs/email-sending-limits.md): The daily and hourly email limits on Pro and Managed, for your own Gmail or Outlook and for sending inboxes Revnu buys. The sending window and time zone, weekday-only and holiday sending, how to send more, how to spread a big batch of approvals, and what day one realistically looks like. - [Where Is My Email? Drafted, Queued, Sent](https://revnu.com/docs/email-status.md): What each lead status tab on the Leads page means, from Prospects to Bounced, how those tabs differ from the status menu (Contacted, Meeting Booked, Customer, Not a Fit), where to see how many emails went out, who presses send, and why an approved email can still be held back. - [How Do Revnu's Emails Look When They Arrive?](https://revnu.com/docs/email-formatting.md): What a Revnu email looks like in the recipient's inbox. Plain text with paragraphs and line breaks, links, what happens to images and attachments, where to see the real email before and after it sends, why some emails sit in Gmail Drafts, and what to do if an email arrives as one block of text. - [Replies and Booking Calls](https://revnu.com/docs/replies.md): Where prospect replies show up, how Revnu drafts a response with your booking link, why every reply waits for your approval, what happens to follow-ups, and how to reply from Gmail yourself. - [Keep People Off Your Outreach](https://revnu.com/docs/exclude-contacts.md): Stop Revnu contacting existing customers, competitors, partners or people who left, with the block list in Settings > Agent and the status menu on each lead. Exactly what a domain, email or LinkedIn entry blocks on email and LinkedIn, and why unsubscribes are permanent. - [LinkedIn Invites, Messages and Replies](https://revnu.com/docs/linkedin-outreach.md): How Revnu runs LinkedIn outreach. Where a LinkedIn sequence lives, what Approve does on each LinkedIn card, which approval settings cover which sends, how to change a connection note or follow-up, moving an email campaign to LinkedIn, mixing LinkedIn and email, where replies go, and when LinkedIn is the wrong channel. - [LinkedIn Limits and Account Safety](https://revnu.com/docs/linkedin-limits.md): How Revnu keeps your LinkedIn account safe, how many invites it sends a day, and why nobody is accepting your connection requests yet. The four-week ramp, a normal first week, weekday working hours, the 90-action daily cap and how to see who accepted. - [Social Posts: LinkedIn, X, Reddit, HN and More](https://revnu.com/docs/social-posts.md): Revnu writes posts for LinkedIn, X, Threads, Bluesky, Reddit, Hacker News and your Google Business Profile in your voice, and hands you a one-tap share link to press Post. Help with comments once a Show HN or Reddit post is live, captions for Instagram, Pinterest and Facebook, images, and how to switch a channel off for good. ## Ads - [How Revnu Runs and Judges Your Ads](https://revnu.com/docs/how-revnu-runs-ads.md): What ads Revnu makes on each channel, who it targets, how it tests ideas and judges them on real results instead of clicks, when it pauses a losing ad and why not sooner, how to swap in your own creative, and how it grows apps and runs video. - [Ad Budgets, Spend Approval and Who Pays](https://revnu.com/docs/ad-budgets.md): How your ads budget works in Revnu. What you approve when Revnu asks for an amount a day, one monthly budget across every channel, the platform billing your own ad account, why ads paused early, the smallest budget each channel runs, ad credit, currencies, and how to relaunch safely. - [Set Up Outcomes](https://revnu.com/docs/set-up-outcomes.md): Tell Revnu which result your ads should bring in, a purchase, a trial start or a booked call, and get it reported to every connected ad platform. What works with no code access, Cal.com and Calendly bookings, which outcome to put first, and what to do when a row says Receiving. - [Connect Meta (Facebook and Instagram) Ads](https://revnu.com/docs/meta-ads.md): Connect your Meta ad account so Revnu can build Facebook and Instagram ads as paused drafts, launch them with your approval, optimize them for the purchases, subscriptions or sign-ups your own pixel already tracks, and report results, including ads you made yourself in Ads Manager. - [Can Revnu Review the Google Ads Campaigns I Already Run?](https://revnu.com/docs/review-existing-ads.md): Yes. Connect Google Ads and ask which campaigns to scale, keep or cut. What Revnu reads, why it judges your own campaigns on Google's conversions, where the verdict appears, what it can change with your yes, how to make the calls trustworthy on payments, and what it can read on Microsoft and Reddit. ## SEO & AI Search - [Get Revnu's Posts Onto Your Site](https://revnu.com/docs/blog-setup-options.md): Which way to publish Revnu's posts for your kind of site, from Next.js and static sites to Wix, Lovable, Webflow, Shopify and WordPress, a subfolder or a subdomain, a reverse proxy, a headless CMS, and how to keep your old posts. - [The Revnu-Hosted Blog and Your Own Domain](https://revnu.com/docs/hosted-blog.md): You approved a post and it's on a revnu.sh address. What that address is, how to move the blog to blog.yourdomain.com with one DNS record, how to put it at yourdomain.com/blog with a reverse proxy, canonical tags, and what happens to the blog if you cancel. - [Connect GitHub: Pull Requests for Posts and Site Fixes](https://revnu.com/docs/github-blog-posts.md): Connect your site's GitHub repo and Revnu opens pull requests for new posts and for site fixes, such as copy, new pages and audit fixes. What access it asks for, how images get in, what you review and merge, and what to do if your site has no code repo. - [Control What Gets Published](https://revnu.com/docs/blog-posts-control.md): On Pro, Revnu's posts publish on their own after a hold unless you choose Ask Me First. How to review posts first, the three-draft limit, getting more than one post a day, undoing an edit to a live post, taking posts down, writing your own, images, house rules and private articles you won't publish. - [Will Google Penalise AI-Written Posts? How Revnu Checks Them](https://revnu.com/docs/ai-written-posts.md): Google ranks posts on whether they help the reader, not on who or what wrote them. How Revnu picks topics, researches and fact-checks every post, what it refuses to publish, and how to review each post before it goes live. - [What Are AEO and GEO? AI Search Optimization Explained](https://revnu.com/docs/what-are-aeo-and-geo.md): AEO (answer engine optimization) and GEO (generative engine optimization) mean getting your business named and cited when people ask ChatGPT, Claude, Gemini, Perplexity, Copilot and Google AI Overviews for a recommendation. Here's how it differs from classic SEO, what to measure and how Revnu does the work for you. - [How Do AI Answer Engines Choose What to Cite?](https://revnu.com/docs/how-ai-engines-choose-sources.md): How ChatGPT, Perplexity, Gemini, Claude, Copilot, Google AI Overviews and AI Mode decide which brands to name and which pages to cite. Covers training data versus live search, search expansions (query fanouts), sources versus citations, the kinds of pages engines trust, crawler access with robots.txt and llms.txt, and how Revnu shows each part. - [AI Visibility: What the Numbers Mean](https://revnu.com/docs/ai-visibility.md): A glossary for your AI visibility report. How to read Visibility, Share of Voice, Citation Share, Mention Rate, Avg. Position, Top-1 Rate and the rank columns, what the Platforms, Sentiment, Competitors, Search Expansions and AI Citations pages show, which AI engines each plan checks, adding questions and competitors, and how Revnu turns gaps into work. - [How Do I Pick the Right Prompts to Track?](https://revnu.com/docs/pick-prompts-to-track.md): How to choose the buyer questions Revnu tracks across ChatGPT, Claude, Gemini and Perplexity, plus Google AI Overviews, Google AI Mode, Copilot and more on Managed. Covers prompts versus keywords, intent, topics, where to find real buyer wording, how many prompts to track, what to avoid and how to add, edit and review them. - [How Do I Get My Brand Cited in ChatGPT and Other AI Answers?](https://revnu.com/docs/get-cited-in-ai-answers.md): A step-by-step AEO and GEO playbook for getting your business named and cited by ChatGPT, Claude, Gemini and Perplexity, plus Google AI Overviews, Google AI Mode, Copilot and more. Find your gaps, fix your pages, publish the posts answers need, get listed where answers look, show up in cited Reddit threads and measure what moved, with prompts you can copy into Revnu. - [Connect Google Search Console](https://revnu.com/docs/search-console.md): Connect Search Console so Revnu can read your clicks, impressions and queries, pick topics from real searches, submit your sitemap and check indexing. What it changes, which property it reads, and when numbers appear. - [Free Directory Listings](https://revnu.com/docs/directory-listings.md): Revnu gets your business listed on the free directories, review sites and "best X" lists that AI answers cite. Which steps it does, which need you, and why it does no paid placements or backlink outreach. - [Get a Site Audit](https://revnu.com/docs/site-audit.md): Ask Revnu in chat to audit your website or blog. It fetches your live pages, checks what Google and AI engines actually see, and gives you a prioritised fix list you can hand to a developer or have Revnu ship as a pull request. ## Results & Reports - [Your Results: What Each Number Means](https://revnu.com/docs/results-explained.md): What the This Week numbers on Home count, what sent, delivered and bounced mean, whether replies include out-of-office, why high opens with no replies happen, how to ask for a campaign read-out, and what the lead score means. - [Daily Updates and the Monday Report](https://revnu.com/docs/reports.md): When Revnu messages you with results, how to get a message every morning even when nothing changed, how to change or turn off the daily update, where to check replies, and what the trial-end recap covers. - [Read Your Ads Results](https://revnu.com/docs/ads-results.md): Where to see spend, clicks and conversions for each campaign, where Revnu's verdict on your own campaigns lives, how to read its cut, keep or push calls, how to get a date range or a recommendation without anything changing, why there may be nothing to measure yet, and how to check each ad platform is receiving your conversions. - [What Results to Expect, and When](https://revnu.com/docs/what-to-expect.md): What Revnu gets done in your first day, first week and first month. Customers have had interested buyers replying within 18 hours of sign-up, sales calls in week one and AI naming them ahead of category leaders. Here's how to get the same. ## Plans & Billing - [Pro vs Managed: Which Plan Is Right for You](https://revnu.com/docs/plans.md): Pro is one AI agent running every growth channel for you, from your own sign-up. Managed is everything in Pro plus a growth engineer from our team, Revnu's most capable model, unlimited leads and workflow runs, zero data retention, every AI engine checked daily and sending set up for you. Compare them, and see how to upgrade. - [How Long Is the Free Trial, and When Am I Charged?](https://revnu.com/docs/free-trial.md): How Revnu's free day works, and how the sign-up screen and checkout show your exact offer before you pay. What you get if you pay today, why a card is asked, extra free days, the reminders before the end, and how to cancel. - [Cancel Your Trial or Plan](https://revnu.com/docs/cancel.md): Cancel in Settings > Account with Cancel Trial or Cancel Plan, not in chat. When access ends, what stops and what stays, whether you keep your blog, how to keep your leads, the refund policy, YC-deal accounts, and stopping Revnu's emails. - [Payment Failed or Card Declined](https://revnu.com/docs/payment-problems.md): What happens when a payment fails, the three days before Revnu pauses, how to pay or approve the payment (3DS and Indian RBI e-mandates), checkout in the Instagram or Facebook browser, prepaid cards, why a card that worked at sign-up gets declined, and whether queued emails and ads survive. - [When Is My Next Payment? Change Card and Get Invoices](https://revnu.com/docs/billing-and-invoices.md): See your next payment date, amount and renewal in Settings > Account. Change the card or payment method, download invoice PDFs, find older invoices, change who gets billed, and how billing and past invoices work on Managed and YC-deal accounts. - [YC and Startup Program Deals](https://revnu.com/docs/startup-deals.md): The YC deal terms by batch, what's included (a growth engineer and your own Slack channel), how to redeem on Bookface, how to get the deal onto the account you actually use, what is charged and when, and how to end it. - [Come Back After Cancelling](https://revnu.com/docs/come-back.md): How to restart Pro on the same account, why a restart after a cancelled trial charges at once, what starts again on its own, what is still there, what you need to connect again, why there's no billing pause, and how to take a break by cancelling and restarting. - [How Do I Delete My Revnu Account and Data?](https://revnu.com/docs/delete-account.md): There's no delete button. Cancel your trial or plan in Settings > Account, disconnect Gmail and LinkedIn, then email support@revnu.com from your sign-in address asking to delete your account. Whether you'll be charged, what deletion covers, and which of Revnu's emails stop. ## Troubleshooting - [Why Did Revnu Stop Working?](https://revnu.com/docs/agent-stopped.md): The reasons Revnu pauses or goes quiet, from a card request on a no-card trial to a failed payment, a daily limit or a card waiting in Review, and how to fix each one. - [Why Aren't My Emails Sending?](https://revnu.com/docs/emails-not-sending.md): A checklist, in order, for when Revnu's emails aren't going out. Each check says where to look and how to fix it, from an approval that's still waiting to a payment problem, plus what happens to emails that were waiting. - [Why Did LinkedIn Sending Stop?](https://revnu.com/docs/linkedin-paused.md): Revnu pauses LinkedIn for at least 72 hours when LinkedIn rate-limits or restricts your account, longer if LinkedIn names a later retry time, and for 24 hours after three errors in a row. How to see why and until when, whether Premium or reconnecting ends it early, and what happens when it resumes. - [Why Aren't My Ads Running?](https://revnu.com/docs/ads-not-running.md): Fix ads that aren't running in Revnu. A Google Ads connect that didn't finish, no ad account found, ads paused at or near the monthly budget, a campaign waiting for approval, LinkedIn page access, no usable Meta ad account, the TikTok minimum, and a missing outcome. Each with the fix. - [Why Isn't My Post Live?](https://revnu.com/docs/blog-not-publishing.md): Find out why a Revnu post isn't showing on your site, from a blog that isn't connected or an I've Connected It refusal to posts waiting for approval, a static site that needs a rebuild, DNS still pending, a Failed post, an access error from Revnu's article service or a paused daily post. - [Get Help From a Person and Report a Bug](https://revnu.com/docs/get-help.md): Who to ask for what. Revnu handles questions about the work, and people at support@revnu.com handle your account, billing, refunds, data and bugs. Whether replies to Revnu's emails reach a person, whether you need a call to start, how Managed reaches its growth engineer, and how to report a bug or a bad post. ## Get Started (Developers) - [Revnu for Developers](https://revnu.com/docs/developers.md): The Revnu API, CLI and MCP server let your software read and approve the review queue, message Revnu, pull results and leads, and run workflows. Start here. - [Quickstart](https://revnu.com/docs/quickstart.md): From a fresh token to approving a card and getting a reply from your agent, using nothing but curl. - [How Revnu Works](https://revnu.com/docs/concepts.md): The model behind the API: a growth agent that does the work, review cards for your say-so, and approval settings that decide what ships on its own. The API controls the agent; it doesn't hand you its tools. - [Pro vs Managed: Which Plan Is Right for You](https://revnu.com/docs/plans.md): Pro is one AI agent running every growth channel for you, from your own sign-up. Managed is everything in Pro plus a growth engineer from our team, Revnu's most capable model, unlimited leads and workflow runs, zero data retention, every AI engine checked daily and sending set up for you. Compare them, and see how to upgrade. - [How Long Is the Free Trial, and When Am I Charged?](https://revnu.com/docs/free-trial.md): How Revnu's free day works, and how the sign-up screen and checkout show your exact offer before you pay. What you get if you pay today, why a card is asked, extra free days, the reminders before the end, and how to cancel. - [Sign Up for Revnu From an AI Agent](https://revnu.com/docs/agent-signup.md): Tell Claude, ChatGPT, Codex or another assistant "Set me up with revnu.com" and it creates your Revnu account, researches your business and hands you the checkout. You sign in and pay yourself. - [Use Revnu From Your Coding Agent](https://revnu.com/docs/coding-agent.md): Connect Revnu to Claude Code, Codex, Gemini CLI or Cursor so your coding agent can hand Revnu growth jobs, report what's waiting for you, and read results, under its own token. ## API Basics - [Build a Growth Agent or Use Revnu? API, CLI, MCP or Chat](https://revnu.com/docs/api-cli-mcp-or-chat.md): Is Revnu just a wrapper you could build with Claude Code? What a do-it-yourself growth agent has to build, what Revnu's API, CLI and MCP server expose and don't, and which way of talking to Revnu to use. - [Authentication and Scopes](https://revnu.com/docs/authentication.md): How personal tokens work, the seven scopes, which scopes can cause work, the smallest set for a read-only dashboard or a status bot, and what a read-only token can't tell you. - [Rate Limits](https://revnu.com/docs/rate-limits.md): Per-token limits for reads, writes and agent messages, the account-wide ceiling, burst allowances, and what to do on a 429. - [Errors](https://revnu.com/docs/errors.md): Every error the Revnu API returns, the JSON body each one carries, and whether to retry, fix the request or re-read the card. - [Changelog](https://revnu.com/docs/changelog.md): What changed in the Revnu API, CLI, MCP server and these docs, newest first. ## Developer Guides - [Build a Review Screen](https://revnu.com/docs/build-a-review-screen.md): Put your review queue on a wall, in Slack or in your admin, driven entirely by each card's actions. - [Talk to Your Agent](https://revnu.com/docs/talk-to-your-agent.md): Send Revnu messages from code, wait for the reply inline or poll, hand over many jobs in a row without interrupting, and keep retries safe with a client request id. - [Pull Results Into Reporting](https://revnu.com/docs/pull-results-into-reporting.md): Read the scoreboard Revnu reads, plus workflows and run history, into your own dashboards, and post a weekly Slack summary of sends, replies, reply rate and who replied. Or ask Revnu to post it for you, with no code. - [Inbound Webhooks](https://revnu.com/docs/webhooks.md): Give your backend, form or billing tool a secret URL. Every JSON POST to it hands Revnu the payload to act on, under your normal approvals. 60 an hour per hook. For events Revnu sends to you, see Outbound Webhooks. - [Outbound Webhooks](https://revnu.com/docs/outbound-webhooks.md): Revnu POSTs a signed JSON event to your URL when a LinkedIn invite is sent, accepted or replied to, so a CRM sync doesn't have to poll. Retried for about two days. - [Preview a Plan Without an Account](https://revnu.com/docs/preview.md): POST a website to /api/v1/preview with no token and Revnu researches the business, returns what it learned with sources, and hands back a claim link that turns the research into an account. Caps, 429s, reuse and the claim flow. ## CLI & MCP - [Install the CLI](https://revnu.com/docs/cli.md): The revnu command. Sign up and set up a new account from a terminal or a coding agent with setup --json and its exit codes, then every API route as a subcommand with JSON on stdout. - [MCP Server Setup](https://revnu.com/docs/mcp.md): Connect Claude Code, Codex, Gemini CLI, Claude, ChatGPT, Cursor, VS Code or any MCP host to Revnu, as a remote connector or a local server. The permissions each tool needs, which tools send or publish, and how to reconnect a broken connector. ## API Reference - [Get the current token](https://revnu.com/docs/me.md): Who this token is: label, scopes, the account it belongs to, whether the account is still in setup, and the rate limits it is held to. Needs no scope. - [List the review queue](https://revnu.com/docs/review-list.md): What is waiting for the customer's approval, each card carrying the verbs it offers and the label for its main button. LinkedIn and gift cards list approve but are approved in the dashboard only. - [Get one card](https://revnu.com/docs/review-get.md): Retrieve a Revnu review card by ID in any status. Read its full draft payload, resolution and resolved time with the review:read API token scope. - [Search review history](https://revnu.com/docs/review-search.md): Check existing work for several people or topics in one request, including resolved cards, without returning full drafts. - [Answer a card](https://revnu.com/docs/review-answer.md): Resolve a card the way the dashboard's primary button would: approve, answer a question, or choose an option. - [Send an email card](https://revnu.com/docs/review-send.md): Approve and send an email draft or reply Revnu wrote, optionally with an edited reply body. This sends real email. - [Request changes](https://revnu.com/docs/review-request-changes.md): Send a card back to the agent with feedback. A revised version returns to the queue. - [Snooze a card](https://revnu.com/docs/review-snooze.md): Snooze a Revnu review card until a future timestamp through the API. Hide it from review and cancel its auto-ship deadline with the review:write scope. - [Dismiss a card](https://revnu.com/docs/review-dismiss.md): Decline a card. It closes without shipping, the agent's trust for that kind of work resets, and the reason teaches it. - [Send a message](https://revnu.com/docs/agent-messages.md): Message your agent exactly as the dashboard chat does, and optionally hold the request open for the reply. - [Poll a message](https://revnu.com/docs/agent-message-status.md): One message's status and every reply the agent has sent since it landed. - [Read the thread](https://revnu.com/docs/agent-thread.md): Read your API token's conversation with the Revnu agent, newest first. Retrieve message text, roles, timestamps and request IDs to rebuild conversation history. - [Get agent status](https://revnu.com/docs/agent-status.md): Whether the agent is up and busy: sandbox state, last activity, and the next scheduled wake. - [Get results](https://revnu.com/docs/results.md): The growth scoreboard for a window ending now: per-channel sections for email, outbound, LinkedIn, SEO, AI answers and ads, each available with data or unavailable with a reason. - [List workflows](https://revnu.com/docs/workflows.md): The account's recurring workflows with their schedule, next run and step list. - [List workflow runs](https://revnu.com/docs/workflow-runs.md): List a Revnu workflow's runs through the API, newest first. Inspect run status, per-step outcomes, and counts of leads, contacts and people found by each run. - [Run a workflow now](https://revnu.com/docs/workflow-run.md): Start a workflow's next run within about a minute, without changing its schedule. - [Create a workflow](https://revnu.com/docs/workflow-create.md): Compose a recurring workflow from a schedule in plain words and a list of steps. - [Update a workflow](https://revnu.com/docs/workflow-update.md): Change a workflow's name, schedule, steps, destination or status. Steps are replaced whole. - [Pause a workflow](https://revnu.com/docs/workflow-pause.md): Pause a Revnu workflow through the API without losing its steps or run history. Cancel its pending wake and keep it paused until you explicitly resume it. - [Resume a workflow](https://revnu.com/docs/workflow-resume.md): Set a paused workflow live again; the next run is scheduled from its cadence. - [Delete a workflow](https://revnu.com/docs/workflow-delete.md): Remove a workflow. Nothing fires again, and it drops out of every read. - [List leads](https://revnu.com/docs/leads.md): Leads newest first with status, score, primary contact and your own columns, paged by an opaque cursor. Draft bodies are only on GET /leads/{id}. - [Get a lead](https://revnu.com/docs/lead.md): One lead with its contacts, the surfaced draft, and the research behind each column. - [Update a lead's labels](https://revnu.com/docs/lead-update.md): Set vertical, archetype and tags on a lead. The only write on leads: the API can't create leads or change status, drafts or contacts. - [List the block list](https://revnu.com/docs/blocklist.md): The do-not-contact entries the send and research gates enforce, newest first. - [Add block list entries](https://revnu.com/docs/blocklist-add.md): Block companies, mailboxes or LinkedIn profiles from outreach. Idempotent, up to 500 per call. - [Remove a block list entry](https://revnu.com/docs/blocklist-remove.md): Unblock one company, mailbox or LinkedIn profile by the id the list returns. Revnu may then contact them again. Unsubscribes can't be removed. - [Look up a LinkedIn person](https://revnu.com/docs/linkedin-person.md): One person's LinkedIn relationship with each connected account, read live from LinkedIn: connected or not, any pending invite and when it was sent, and the conversation. - [Sync existing customers](https://revnu.com/docs/customer-sync.md): Import signups, trials and customers into Leads and exclude them from cold outreach. - [Get setup status](https://revnu.com/docs/setup-status.md): Where a new account is in setup (website, researching, review, payment, start or done) and the exact next step. Works before the account has paid. - [Set the business website](https://revnu.com/docs/setup-website.md): Give a new account its website. Revnu checks the site exists, then researches the business, which takes about a minute. - [Confirm the business details](https://revnu.com/docs/setup-confirm.md): Save the customer's answers to the setup review. Becomes Revnu's memory of the business, exactly as the dashboard review does. - [Get a checkout link](https://revnu.com/docs/setup-checkout.md): A Stripe Checkout link that starts the customer's subscription, with a free trial when their account has one. The customer finishes it on Stripe's page, where any card is entered. - [Start Revnu](https://revnu.com/docs/setup-finish.md): Once the trial is running, start Revnu's first work now rather than waiting for the automatic start 15 minutes after the trial begins. ## Content API - [Content API](https://revnu.com/docs/content-api.md): Serve the posts Revnu writes on your own site and domain. The Content API returns published posts as JSON, read with an rvc_ token from Visibility → Publishing Settings; covers tokens, rotation, rate limits, the rebuild hook and backing up your posts if you leave. - [List posts](https://revnu.com/docs/content-posts.md): Every published post, newest first, with cursor paging and filters by content type and time. - [Get a post](https://revnu.com/docs/content-post.md): One post, render-ready: markdown and safe HTML, table of contents, head metadata, JSON-LD and related posts. - [Render Posts in Next.js or Astro](https://revnu.com/docs/host-your-blog.md): Complete examples for rendering Revnu posts on your own site with Next.js App Router or Astro, with canonical tags, JSON-LD, a sitemap that drops removed posts, new and edited posts appearing without a deploy, and fixing tables and links that render wrong. ## Measurement - [Install the Revnu Tag](https://revnu.com/docs/revnu-tag.md): One script tag that tells Revnu where your visitors come from, including ChatGPT, Perplexity and other AI assistants, search engines and ads. Where to find your site key, how to keep the server key out of the browser, how it sits beside your existing pixels, and how to check it's live. - [Send Events](https://revnu.com/docs/event-api.md): Tell Revnu from your server when a visitor signs up, books a call or pays, so the result is tied back to where they came from. ## Optional - [How Do I Book Demos With Cold Email?](https://revnu.com/docs/uc-cold-email.md): A step-by-step recipe for booking demos with cold email in Revnu. Tell it who buys, connect Gmail or Outlook, give it your booking link and approve the first sequence. What to send Revnu, what you approve, what you'll see and when replies arrive. - [How Do I Prospect on LinkedIn With Revnu?](https://revnu.com/docs/uc-linkedin.md): A step-by-step recipe for LinkedIn prospecting with Revnu. Connect your LinkedIn, tell Revnu who to reach, approve the sequence once, and it sends invites and messages as you at a safe pace. What to send Revnu, what you approve and how fast it goes. - [How Do I Find Leads in a Niche Market?](https://revnu.com/docs/uc-niche-leads.md): A step-by-step recipe for finding leads in a narrow B2B niche with Revnu. Describe the buyer in one message, block who to skip, and check the first leads. What to send Revnu, how long a list takes, and what to do when the list comes back short or wrong. - [What Buying Signals Can Revnu Find Leads By?](https://revnu.com/docs/uc-buying-signals.md): Example requests for finding leads by buying signal with Revnu. Target companies that are hiring, just raised money, run a certain tool, or have people posting about your problem, then stack signals to find buyers who need you this week. Where each intent signal comes from, including waterfall enrichment from third-party B2B data providers. - [How Do I Reach a List I Already Have, or Event Attendees?](https://revnu.com/docs/uc-list-or-event.md): A step-by-step recipe for outreach to your own list, a directory or the people you want at an event. Upload the file in chat, say what it's for and the dates, approve the sequence, and Revnu researches each name and sends on your timeline. - [How Do I Handle Replies and Book Calls?](https://revnu.com/docs/uc-replies-and-calls.md): A step-by-step recipe for turning outreach replies into booked calls with Revnu. Give it your booking link once, and when someone replies it stops their follow-ups, tells you and drafts an answer that waits for your yes. Where replies show up, how to send the draft, and what to do after a call is booked. - [How Do I Get Found on Google and in ChatGPT With a Blog?](https://revnu.com/docs/uc-seo-blog.md): A step-by-step recipe for running a blog with Revnu so buyers find you on Google and in AI answers. Fill in your product facts, connect a place for posts to live, connect Search Console, choose what waits for you, and track how ChatGPT, Claude, Gemini and Perplexity mention you. - [How Do I Run Paid Ads Without an Agency?](https://revnu.com/docs/uc-paid-ads.md): A step-by-step recipe for running paid ads with Revnu instead of an agency. Connect your ad account, set up the outcome you want, set a monthly budget and approve the test budget. Revnu writes the ads, builds them paused, launches on your yes and judges them on results, not clicks. - [How Do I Get a Weekly Growth Report for Me or My Investors?](https://revnu.com/docs/uc-weekly-report.md): A step-by-step recipe for a weekly growth report from Revnu. What the Monday roll-up already covers, how to set up a report with your own numbers at a fixed time, how to have Revnu draft your investor update, and how to ask for any period. - [How Do I Find Companies With Revnu?](https://revnu.com/docs/uc-find-companies.md): Find the companies that need you this week, not just the ones that fit on paper. Every filter Revnu can search companies by (funding, hiring, tech stack, investors, industry, size, location, founding year) and every field on a company record, with copyable example requests. - [How Do I Find People and Their Contact Details With Revnu?](https://revnu.com/docs/uc-find-people.md): Find the exact people who buy what you sell, and a checked work email for each. Every filter Revnu can search people by (job title, seniority, company, company size, location, past employers, schools, LinkedIn posts and engagement), what every person record carries, and how waterfall enrichment finds and verifies emails. - [GTM Plays You Can Run With Revnu](https://revnu.com/docs/play-overview.md): Proven go-to-market plays you can hand to Revnu in one message, from closed-deal lookalikes and competitor price increases to LinkedIn commenters, hiring signals and comparison pages. Each play has the steps, a copyable prompt and a way to run it every day or week. - [How Do I Turn My Last Closed Deal Into More Deals?](https://revnu.com/docs/play-closed-deal-lookalikes.md): A GTM play for Revnu. Take your latest closed deal, work out what was happening at that company the week they said yes, find every company in the same industry with the same thing happening now, and open with why they match and who you just closed. - [How Do I Win Customers When a Competitor Raises Prices?](https://revnu.com/docs/play-competitor-price-increase.md): A GTM play for Revnu. When a competitor announces a price increase, find the companies using that product who should switch, work out what switching takes, and reach them by email and LinkedIn with a low-barrier offer. Test the offers and scale what gets replies. - [How Do I Turn a Competitor's LinkedIn Commenters Into Leads?](https://revnu.com/docs/play-competitor-linkedin-commenters.md): A GTM play for Revnu. List the LinkedIn profiles of 10 or more competitor founders, pull their recent posts, collect everyone who commented or reacted, keep the real buyers who fit your ICP, find verified emails and open with the comment they left. Run it daily for fresh leads. - [How Do I Find People Asking for a Tool Like Mine?](https://revnu.com/docs/play-buying-intent-posts.md): A GTM play for Revnu. Every day, people post "anyone recommend a good [tool]?" or "looking for an alternative to [competitor]". Revnu finds those posts on LinkedIn and Reddit, finds the person and their work email, and reaches them while they're still deciding. - [How Do I Reach People Who Left a Bad Review of a Competitor?](https://revnu.com/docs/play-competitor-reviews.md): A GTM play for Revnu. Find the one and two star reviews of your competitors from the last 90 days, on review sites and Reddit, work out who wrote them and where they work, and send a short email about the exact thing they complained about. - [How Do I Use Job Posts to Find Companies That Need Me?](https://revnu.com/docs/play-hiring-signal.md): A GTM play for Revnu. A job post tells you a company's problem, its budget and the tools it uses. Revnu finds companies hiring for the role you help with, reads each posting, and writes an email built from what the company said it needs. - [How Do I Reach Companies That Just Raised Money?](https://revnu.com/docs/play-fresh-funding.md): A GTM play for Revnu. A company that just raised a round has new budget and a plan to spend it. Revnu finds companies in your market that raised in the last 30 days, finds the leader who owns your problem, and writes about the growth the round is meant to buy. - [How Do I Find My Customers' People at Their New Jobs?](https://revnu.com/docs/play-champion-job-changes.md): A GTM play for Revnu. People who used your product at their last job already know it works. Revnu finds people who used to work at your customers, in the role that buys from you, now at a new company that fits your buyer, and writes to them as the familiar face they are. - [How Do I Turn My LinkedIn Post Engagers Into Leads?](https://revnu.com/docs/play-your-post-engagers.md): A GTM play for Revnu. Every week, collect the people who reacted to or commented on your own LinkedIn posts, keep the ones who fit your buyer, and follow up by LinkedIn and email while you're top of mind. - [How Do I Find Buyers Through the Experts They Follow?](https://revnu.com/docs/play-influencer-engagers.md): A GTM play for Revnu. Pick 20 people your buyers follow on LinkedIn for advice. Every day, Revnu reads their new posts, collects the people who engage, scores each one against your buyer profile, and reaches the best fits by LinkedIn and email with an offer they want. - [How Do I Book Meetings Before a Conference Even Starts?](https://revnu.com/docs/play-event-attendees.md): A GTM play for Revnu. Four weeks before a conference, Revnu finds the people posting about going, the speakers and the exhibitors, keeps the ones who fit your buyer, and writes to set up a coffee at the event. You arrive with a calendar full of meetings. - [How Do I Find Leads in Public Lists Nobody Else Is Using?](https://revnu.com/docs/play-public-lists.md): A GTM play for Revnu. Trade association member directories, exhibitor lists, partner directories, licensing registries and public contract award notices are lead lists nobody mines. Give Revnu the link, and it turns the page into researched leads with a reason to write. - [How Do I Rank for "Alternatives to [Competitor]" Searches?](https://revnu.com/docs/play-alternative-pages.md): A GTM play for Revnu. People searching "[competitor] alternative" or "[competitor] vs [competitor]" are ready to buy. Revnu writes honest comparison and alternative pages from your product facts, publishes one a day, and refreshes the ones Search Console shows slipping. - [How Do I Find and Pitch Local Businesses?](https://revnu.com/docs/play-local-businesses.md): A GTM play for Revnu. Sell to dentists, gyms, clinics, salons or contractors? Revnu pulls every local business of that type in your cities from Google Maps, reads their reviews for the problems customers mention, finds the owner, and writes an email about the problem their own customers raised. - [How Do I Spy on Competitor Ads With Revnu?](https://revnu.com/docs/play-competitor-ads.md): Use Revnu to research competitor ads in the public ad libraries of LinkedIn, Meta, Google, TikTok, X, Reddit and Microsoft. Find who advertises on your keywords, read their offers and landing pages, find the gaps, draft better ads, watch for new ads every week, and turn active advertisers into warm leads. - [How Do I Research Competitor Ads in the LinkedIn Ad Library?](https://revnu.com/docs/ads-library-linkedin.md): Revnu searches the LinkedIn Ad Library by keyword or advertiser and shows you who's advertising, their headlines, calls to action and creative, and how long each ad has run. Then it writes better LinkedIn ads for you and turns active advertisers into leads. - [How Do I Research Competitor Ads in the Meta Ad Library?](https://revnu.com/docs/ads-library-meta.md): Revnu pulls your competitors' Facebook and Instagram ads from the Meta Ad Library, groups them by hook and offer, reads the landing pages, and shows which ads have run longest. Then it drafts your own Meta ads and finds companies running ads that fit as leads. - [How Do I Research Competitor Ads on Google?](https://revnu.com/docs/ads-library-google.md): Revnu pulls a competitor's ads from the Google Ads Transparency Center across Search, YouTube, Display and Shopping, reads the offers and landing pages, and finds who else advertises to your buyers. Then it drafts your own Google ads and turns active advertisers into leads. - [How Do I Research Competitor Ads on TikTok?](https://revnu.com/docs/ads-library-tiktok.md): Revnu pulls ads from the TikTok Ad Library and TikTok Creative Center, so you can see what your competitors run on TikTok and which ads top your industry. It breaks down the hooks, offers and calls to action, then briefs your own TikTok ads. - [How Do I Research Competitor Ads in the X Ads Repository?](https://revnu.com/docs/ads-library-x.md): Revnu pulls your competitors' ads from the X Ads Repository, the public record of ads shown on X in Europe. It reads what they promote and how, then writes your own X ads and finds active advertisers worth reaching out to. - [How Do I Research Top Reddit Ads?](https://revnu.com/docs/ads-library-reddit.md): Revnu pulls top performing Reddit ads from the Reddit Ads Inspiration Library by keyword and industry, reads their formats, angles and landing pages, and reads the threads where your buyers talk. Then it writes Reddit ads that sound like they belong there. - [How Do I Research Competitor Ads in Microsoft's Ad Library?](https://revnu.com/docs/ads-library-microsoft.md): Revnu pulls ads from the Microsoft Ad Library, the public record of ads shown on Bing and Microsoft's network in Europe. See who advertises on your keywords, read their copy and landing pages, and have Revnu build your own Microsoft Search campaign.