# Ryze API for agents Source: https://help.get-ryze.ai/agent-api Let your AI agent sign up for Ryze, get an API key, and call every Ryze tool over MCP or REST. Your agent can create a Ryze account, get an API key and start working without you opening the app. You step in three times: * read the code from the email * pay, when the agent sends you the payment link * click the link to connect an ad platform ## 1. Sign up The agent sends your email: ```bash theme={null} curl -X POST https://reports.get-ryze.ai/api/v1/agent/signup \ -H "Content-Type: application/json" \ -d '{ "email": "you@company.com" }' ``` Ryze emails an 8-digit code with the subject **"… is your Ryze code"**. It is valid for 1 hour. The email tells the user to share it only with their own agent. Calling signup again sends a new code; use the newest one. ## 2. Verify You give the agent the code. The agent sends it back with your website: ```bash theme={null} curl -X POST https://reports.get-ryze.ai/api/v1/agent/verify \ -H "Content-Type: application/json" \ -d '{ "email": "you@company.com", "code": "12345678", "domain": "company.com", "name": "My agent" }' ``` * `domain` is the business website. Free email domains such as gmail.com are refused. * `name` is optional and labels the key in your settings. The response carries the key. It is shown once, so the agent should store it: ```json theme={null} { "api_key": "rk_live_...", "workspace_id": "...", "mcp_url": "https://connector.get-ryze.ai/mcp", "api_url": "https://reports.get-ryze.ai/api/v1", "docs_url": "https://help.get-ryze.ai/agent-api" } ``` * A new email gets a new account with a workspace for the domain. * An email that already has a Ryze account gets a key for every workspace it can open. `workspace_id` is the one whose website matches `domain`, or `null` when none or several match; `native__get_workspaces` lists them all. * Lost the response? Run signup and verify again. An existing account just gets another key, and old keys keep working until revoked. ## 3. Call tools The key works the same way over MCP and REST. Both expose the same tools. ### MCP Connect your MCP client to `https://connector.get-ryze.ai/mcp` with the header `Authorization: Bearer rk_live_...`. Keys work on `/mcp` only, not on `/sse`. After a platform is connected, its tools come with the next tool list; a client that caches the list may need to reload the connector. ### REST List the tools with their descriptions and input schemas: ```bash theme={null} curl https://reports.get-ryze.ai/api/v1/tools \ -H "Authorization: Bearer rk_live_..." ``` Call one by name. Arguments go inside `args`: ```bash theme={null} curl -X POST https://reports.get-ryze.ai/api/v1/tools/native__list_connections \ -H "Authorization: Bearer rk_live_..." \ -H "Content-Type: application/json" \ -d '{ "args": {} }' ``` When the key covers several workspaces, pass `"workspace"` inside `args`: a name from `native__get_workspaces`. ## 4. Subscription A new account has no subscription yet. Tools whose entry in `GET /api/v1/tools` has `requires_plan: false` work without one: today `native__get_workspaces`, `native__list_connections`, `native__create_connection_link` and `native__get_connection_link`, so the agent can connect platforms right away. Every other tool answers `subscription_required`; its `message` holds the link to start or fix the plan: send it to the user and retry after they do. ## 5. Connect ad accounts Connect a platform in 3 steps: * call `native__create_connection_link` with the provider, for example `meta_ads` * send the returned `url` to the user: it opens the platform's sign-in or a page for its API key, then they pick the accounts Ryze should use * poll `native__get_connection_link` with the returned `link_id` and the same `workspace` every \~30 seconds until `status` is `connected`; the platform's tools then appear in `GET /api/v1/tools` `status` is `waiting` until the user signs in, `connected` once the platform is connected (the user may still be picking accounts for a minute), and `expired` when the link is gone (check `native__list_connections` then). In Claude and ChatGPT the link shows as a card with a Connect button that turns green by itself once the platform is connected (after 20 minutes it stops checking and offers a Check again button). The link works once and expires after 24 hours; a sign-in started in its last 15 minutes still gets 15 minutes to finish. It never signs anyone in to Ryze: whoever opens it can only connect a platform to that workspace. Links work for every platform Ryze connects except GitHub, custom MCP servers and Ryze Sites, which are set up in the Ryze app. OAuth platforms open their sign-in (Microsoft Ads with a Microsoft account; Shopify asks for the store domain first). Platforms connected with an API key, such as Klaviyo, Semrush or WordPress, open a page where the user pastes it. If a platform that allows one connection per workspace is already connected, the link is refused so it never replaces it. ## Errors A tool that ran but refused answers HTTP 200 with a `status`: | `status` | Meaning | | - | - | | `invalid_arguments` | Wrong or missing arguments, or a request that can't be done as asked (for example the platform is already connected). `message` says why. Tool arguments go inside `args`, never next to it. | | `subscription_required` | No active plan, or its payment failed. `message` holds the link to fix it. | | `out_of_credits` | The plan's credits are used up. | | `not_allowed` | The platform refused the action. | | `not_found` | The object, the tool or the provider does not exist. | | `not_connected` | The platform is not connected. Use a connection link. | ```json theme={null} { "status": "subscription_required", "message": "... https://reports.get-ryze.ai/pay/..." } ``` Problems with the request itself answer with an HTTP error and `{ "error": "..." }`: | HTTP | When | | - | - | | 400 | Invalid signup or verify body, wrong code | | 401 | Missing, invalid or revoked key | | 403 | The key is valid but its user has no workspace | | 404 | The path is not an endpoint. The API is `POST /api/v1/agent/signup`, `POST /api/v1/agent/verify`, `GET /api/v1/tools` and `POST /api/v1/tools/{name}`. | | 429 | The code email could not be sent right now. Wait a minute and call signup again. | ## Manage keys Your keys are listed in the app under **Workspace Settings → Profile → API keys** (account menu at the bottom left → **Workspace Settings**). Keys belong to your login, so they work for every workspace you can open. * **Create key** makes a key without the signup flow: name it, copy it, give it to your agent. It is shown once. * **Revoke** deletes a key and stops it at once. # Inbox and approvals Source: https://help.get-ryze.ai/agent/approvals The agent finds improvements in your accounts on its own and brings them to your Inbox for sign-off — you approve, it applies the change. Prefer video? Watch the [Approvals guide](/guides/approvals). Approvals flip the direction of work. Instead of you checking dashboards for problems, the agent continuously researches your connected accounts — SEO and paid — and when it finds something worth fixing, it files a proposal. You review the exact change, approve or reject, and on approval the agent applies it. Proposals land on **Home**, in the **Needs you** list — the badge on Home shows how many are waiting. Click **View all** to open the **Inbox** with everything that needs your decision. ## What a proposal looks like Every proposal is specific and grounded in your data — never "consider improving X". Open one to see: * **Title and description** at the top — what's wrong, what it costs you, and why it matters, with real numbers from your accounts. * **Entity** — the exact account and campaigns the change touches. * **Proposed changes** — a before/after table of every change the agent wants to make. * **Evidence** — the data the agent pulled to reach its conclusion. Each proposal is labeled **SEO** or **Paid Ads**, so you can tell at a glance which part of your marketing it touches. ## Approve or reject * **Approve** — the agent applies the change to your account and verifies it landed. Use the arrow next to the button to pick **Approve with a note** when you want something done differently — for example "keep the daily budget at €20" or "apply only to the UK campaign". The agent reads your note before touching anything. * **Reject** — nothing is touched. You can add an optional reason, which helps the agent propose better changes next time. ## After you decide * An approved card moves to **Applying**, then to **Applied** — with an **Agent note** on what was done — or to **Failed**, with **Why it wasn't applied**. **Already resolved** means the agent re-checked and the problem was already gone. * Your note from **Approve with a note** is shown on the card as **Your note**. * **Expected impact** shows the estimated effect (**est.**) or, once there's data, the measured one (**measured**). * **Tracing** → **View research run** or **View apply run** opens the agent's chat for that card, so you can see exactly what it looked at and did. ## Blocked proposals Sometimes the agent finds a real problem but can't fix it from its side — a tag that must be installed on your website, a pixel that needs verifying, a platform it has no access to. Those proposals arrive as **Blocked**: the same evidence and proposed changes, plus a blocker note that tells you exactly what to do and where. * **I fixed it** — tell the agent you've resolved the blocker. It re-checks before proceeding — if the fix is actually live, the proposal moves forward; if not, it stays blocked and tells you what's still missing. * **Acknowledge** — you've seen it and will handle it yourself. ## Opportunities Besides fixes, the agent files a second kind of proposal: an **Opportunity** — demand you aren't capturing yet rather than something that's broken. Today these are SEO cards: a search query with real volume where you're outside the top 20, or a question AI assistants keep answering without naming you. Each opportunity proposes **one new article for your Content Plan**. Instead of a before/after table, the card shows **Setup**: * **Title**, **Primary keyword** and **Archetype** (the type of article) * **Monthly searches**, when there's volume data * **What it must cover** — the points the article has to answer * **Replaces** and **Replaced topic searches** — when the article takes the place of a topic already planned Under **Who can apply it**, the card says **Can be applied by Ryze**: click **Approve** and Ryze writes the article and publishes it like any other Content Plan article. Click **Reject** to skip it. The agent keeps a short backlog, so you see at most a couple of opportunities at a time. ## Other items in your Inbox The Inbox isn't only proposals. It also collects anything else that's waiting on you — for example articles that failed to publish, Technical Audit issues, or a managed campaign whose agent asked you a question. ## Get notified Click **Notifications** at the top of the Inbox to choose who hears about new approvals — pick Slack channels, email recipients, or both, then **Save**. **Also add recipients to this workspace** gives each email address you add a seat in the workspace, with access to everything in it. ## Proposals from scheduled tasks A [scheduled task](/agent/schedules) that finds a change worth making — a budget, bid, targeting, keyword, creative or content change — files it as a card here too. The agent can't read replies to the result email, so don't answer it with "approve" or new instructions: open **Home → Needs you** or the **Inbox** and click **Approve** or **Reject** on the card. To give the agent new instructions, start a new chat or edit the task. ## How proposals are found The agent runs research on a regular cadence per product, in the background — no setup needed. It only files a proposal when it finds something concrete and worth your attention; quiet accounts produce no noise. Research runs are free — you only spend credits when you approve a fix and the agent applies it. The agent does pause research while your organization's credit balance is at zero, so if proposals stop arriving, check your balance first (see [Credits & Usage](/agent/credits)). ## Related Point the agent at your own recurring checks. How agent runs are billed. # Chat with the AI Marketer Source: https://help.get-ryze.ai/agent/chat Open the agent from any page, attach files, choose how much it may change without asking, and find past chats and agent tasks in Chat History. The chat is where you talk to the **AI Marketer** — ask a question, give it a task, or follow up on its work. It reads your connected accounts and can make changes in them, so it's worth knowing how the chat works. ## Two ways to open it * **The AI Marketer button** in the top bar (or **⌘J** / **Ctrl+J**) opens the agent in a side panel on whatever page you're on. In the panel you'll find **Recent chats (last 20 chats)**, **New chat**, and **Open as full chat** to move the conversation to a full page. * **AI Marketer → New chat** in the sidebar opens a full-page chat. Many buttons across the app open the side panel and send their prompt to the agent right away — for example **Create with Agent**, **Generate Report**, **Update Report**, **Improve Brand Profile**, **Fix with agent** and any card on the [Templates](/agent/templates) page. That run starts immediately and uses credits like any other message (see [Credits & Usage](/agent/credits)). ## Write a message * **Attach files.** In a full-page chat, click **+** → **Attach files** → **Upload from computer**, **Choose from Media** or **Upload from Drive**. In the side panel, the paperclip button opens the same three options. You can also drag files onto the chat. * **Reference ads** (in the **+** menu) attaches your own ads or ad templates as references for a new creative. **Image aspect** sets the shape of the creatives the agent makes, or leaves it on **Auto**. * **Record voice** — click the microphone, speak, then **Stop & send**. Your recording is transcribed into the message box. * **Stop generating** — the square button stops the reply while the agent is still answering. Attachments can be images, PDF, DOCX, XLSX or CSV files — up to 3 images and 3 documents per message. Images can be up to 10 MB each, documents up to 20 MB. Images from Google Drive aren't supported — upload them from your computer instead. ## Tool approvals The **Tool approvals** picker in the message box decides how much the agent may do in your connected accounts without asking: | Option | What happens | | - | - | | **Manual approve** | Every tool that touches your data needs your approval. | | **Approve write & delete** | Reads run freely; changes need your approval. | | **Skip all approvals** | The agent runs every tool on its own. | The default is **Skip all approvals**, so the agent can change things in your connected accounts — budgets, campaigns, content — without asking first. If you want to confirm changes, switch to **Approve write & delete** or **Manual approve**. Your choice is remembered in this browser. When a tool is waiting for you, the chat shows **Approve** and **Deny** (or **Approve all** and **Deny all** when there are several). ## Agent tasks Some actions, such as **Fix with agent** on a Technical Audit item, start an **agent task**: the agent works through the job on its own and reports back when it's done, and you can leave while it runs. **Stop agent** halts it after its current step. Agent tasks are billed like any agent run and are listed under **Chat History → Agent tasks**. ## While you chat * **Assets** — the panel at the top right of a chat has three sections: **Tasks** (the agent's to-do list for this chat), **Generations** (creatives and reports made in this chat) and **Context** (files you attached). * Under each reply: **Copy**, and the coin icon showing **N credits used**. Hover it for the breakdown. * **Chat options** menu at the top: **Rename** or **Delete**. Deleting removes the chat and its messages for good. * If you see "Long chats slow the agent down — a fresh one keeps it sharp.", click **New chat** and continue there. The agent can make mistakes. Review what it produces before you rely on it. ## If something goes wrong | Message | What to do | | - | - | | **Out of credits** | Click **Buy credits**, or **Add your key** to run chat on your own [Anthropic key](/integrations/anthropic). | | **Workspace credit cap reached** | This workspace used its monthly credit limit. The organization owner can raise it in **Organization Settings → Usage**. | | **Paid Ads is inactive** | Your subscription is inactive. Click **Manage billing**. | | **Conversation is too large** | Remove large attachments or start a new chat. | | **Agent is over capacity** | The AI provider is briefly overloaded. Retry in a few seconds. | | **Something went wrong** | Click **Retry** to send your message again. | ## Chat History Open **AI Marketer → Chat History**. The page, titled **Chats**, lists the conversations in this workspace, most recently updated first. Use **Search chats** to find one. * **Chats** — your conversations. * **Agent tasks** — jobs the agent ran on its own, with a status: **Queued**, **Running**, **Done** or **Failed**. Hover a row and open its menu to **Rename** or **Delete** it. **New chat** starts a new conversation. Chats created by [scheduled tasks](/agent/schedules), by applying [approvals](/agent/approvals), from Slack and by agent tasks open read-only ("This chat is read-only."). They're a record of what the agent did — to continue, start a new chat. ## Related What each message and agent run costs. Ready-made prompts to start from. # Brand Source: https://help.get-ryze.ai/agent/context The brand context every Ryze agent reads on every turn — shape what the AI writes about you, how it sounds, and what it remembers. Prefer video? Watch the [Setting up your brand guide](/guides/brand). Everything Ryze produces — programmatic articles, on-page copy, off-page mentions, ad creatives, reports — is shaped by one place: your **Brand** profile. It's the brief the agents read on every turn. Get it right and every output sounds like you, sells what you actually sell, and follows your rules. Find it under **Brand** in the sidebar. Ryze builds the first version by reading your site — while it works you'll see "Scanning your site to build your brand profile", and you can close the page. If Brand is empty, click **Generate brand profile** to build it from your site, or **Set up manually** to fill it in yourself. After that you refine it by hand — each card has an **Edit** button — or click **Improve Brand Profile** and the agent reviews what's there, flags anything weak or missing, and asks before changing anything. Like any chat with the agent, that uses credits. At the top is your brand description — what the company does, for whom, and what makes it different; edit it the same way. Below it, four tabs: **Identity**, **Visual**, **Context**, and **Memory**. ## Identity — what you sell and how you sound * **What you sell.** Your **offer**, plus your **industry**. This anchors topic planning, keyword relevance, and the angle of every piece — so a children's furniture store never gets written up like a generic SaaS. * **Tone of voice.** How the brand should sound. Be specific and prescriptive — the agent follows this literally. For example: *"Warm and practical — short sentences, plain language, written for busy parents. Avoids corporate enthusiasm, feature-list marketing, and hollow superlatives."* The more concrete the tone, the less generic the output. Vague tone ("professional, friendly") gives you vague, average copy. ## Visual — colors and fonts Your brand **colors** and **fonts**, which the agent applies to every ad creative it generates. Each color can have a role — **Primary**, **Secondary**, **Accent**, **Background**, **Text** or **Neutral** — so the agent knows where to use it. Logos, product photos and videos don't live here — upload them to **Media** in the sidebar, and the agent picks from them before it looks anywhere else. See [Media library](/workspaces/media) and [AI Ad Creatives](/paid-ads/ai-creatives). ## Context — what the agent should always remember Free-form notes the agent reads before doing anything, in chat and in background work. This is your lever for facts, claims, and guardrails: * Hard facts about your product, pricing, and positioning the AI must get right. * Claims you *can* make and ones you **must not** (legal, medical, compliance). * Differentiators and proof points you want surfaced. * Competitors or comparisons to avoid. * Sources you want cited — industry reports, your own research, authoritative sites in your space — and sources to avoid. ## Memory — what the agent has learned Short facts and rules about your business, one per memory: "Never set a daily budget above \$200 without asking", "campaigns are set up per country". The agent adds memories itself when you tell it something it should keep in mind next time, and you can **Add memory**, **Edit** or **Delete** any of them. Delete a memory and the agent no longer sees it. ## Writing rules for articles Rules that only apply to SEO articles — tone for articles, custom writing instructions (short paragraphs, no em dashes, British spelling), and article examples the writer mimics for structure and style — live in **SEO → Preferences → Content**. See [SEO Preferences](/seo/preferences). ## Why it matters The agents run on this context every single turn — there's no separate "settings" they forget. Edit the Brand page once and the change shows up in the next article, the next optimization, the next creative. It's the highest-leverage place in Ryze: a few minutes here changes everything downstream. Brand is per-workspace. If you run [multiple workspaces](/workspaces/create-workspace), each one carries its own identity, tone, notes and memories — so a single account can serve very different brands without bleed-over. ## Related See the context turned into full, published drafts. Improvements the agent proposes on its own. # Credits & Usage Source: https://help.get-ryze.ai/agent/credits How Ryze charges credits for chat and agent runs, what happens when they run out, and where to track what you spend. You pay for the AI's thinking, not its plumbing. Every time the model reasons — reads your question, looks at tool results, writes an answer — that's one AI step, and steps are what cost credits. ## How a message is charged Every AI step costs **0.5 credits**. There is no model to pick. Ryze chooses the right model for each reply, and the step price is the same whichever one it uses. A simple reply is one step. When the AI pulls data or edits a campaign, it takes an extra step per round of tool results it reads — the tool calls themselves are free. A few tools carry a fixed cost on top, because they do heavy lifting: | Tool | Cost | | - | - | | **Ad creative** (built and rendered from a brief, or re-rendered after an edit) | 2.5 credits per creative | | **Generated photo** (an image the agent generates to use inside a creative) | 0.5 credits per image | | **UGC video** | 10 credits per video | | **SEO data lookup** (rankings, backlinks, keyword data) | 0.5 credits each | | **Competitor ad search** (Ad Library) | 0.5 credits each | | **Web search** and **web page fetch** | 0.1 credits each | Everything else the agent calls is free: Google Ads, Meta, GA4, Search Console, your store and your CMS. ### Examples * **"Hey agent!"** → one step. **0.5 credits.** * **"What's my Google Ads spend this week?"** → pull data, then answer: two steps. **1 credit.** * **"Compare ROAS across my Meta and Google campaigns."** → a few rounds of reports, then the comparison: \~4 steps. **\~2 credits.** * **"Generate 3 ad creatives for our spring launch."** → three creatives (7.5), a few steps, and 0.5 for each photo the agent generates. **Usually 9–12 credits.** A reply showing the credits used ## Agent runs Work the agent does on its own — [scheduled tasks](/agent/schedules), applying [Approvals](/agent/approvals), and agent tasks you start with **Fix with agent** — is billed the same way: 0.5 credits per AI step, plus the fixed-cost tools above. **Background research for Approvals is free.** The agent scanning your accounts for opportunities costs nothing — you only pay when you approve a fix and the agent goes to apply it. Research does pause while your organization's credit balance is at zero, so if proposals stop arriving, check your balance first. ## Through Claude or ChatGPT When you use Ryze through the [Claude](/claude/connect) or ChatGPT connector, the thinking happens in your assistant, on your Claude or ChatGPT plan. Ryze charges **no AI steps** there. Pulling data and making changes in your ad accounts through the connector is free; only the competitor ad search (Ad Library) uses credits. Ad creatives, UGC videos, SEO data lookups and web search run inside the Ryze app, not through the connector. ## See the cost of any reply Hover the credit icon under any AI message to see exactly what it cost. ## What you're not charged for These don't use credits: * **Tool calls** — pulling data, editing campaigns, publishing content: free. You pay for the AI steps around them, plus the fixed-cost tools above. * **Approvals research** — the background scanning that files proposals is on us. * **Managed Campaigns** — the agents that set up and manage a [Managed Campaign](/paid-ads/managed-campaigns) don't use credits. Those are priced on ad spend. * **Chat on your own Anthropic key** — if you connect your own [Anthropic key](/integrations/anthropic), AI steps in chat cost nothing — only the fixed-cost tools do. Agent tasks and other work the agent does on its own always run on Ryze credits. ## Your balance at a glance The coin counter in the top bar shows how many credits you have left. It turns amber below 100 credits and red at zero. If the workspace has a monthly credit cap, it shows what's left under the cap. Click it to see: * **credits remaining** * **Next top-up** and a date — when your plan adds its next allowance * **Buy credits** — buy a credit pack (in a workspace with a cap, only the organization owner sees this button) * **This workspace: N of M this month** — the workspace's credit cap and how much of it is used, if a cap is set * **Connect to Claude** — run the AI on your Claude subscription instead of Ryze credits (see [Through Claude or ChatGPT](#through-claude-or-chatgpt)) ## When credits run out * The chat shows **Out of credits** with **Buy credits**, or **Add your key** to chat on your own [Anthropic key](/integrations/anthropic). * If the workspace hit its monthly cap, the chat shows **Workspace credit cap reached**. The organization owner can raise the cap in **Organization Settings → Usage → Credit caps**. * [Scheduled tasks](/agent/schedules) skip their runs, with a note on the task, until you top up. * Approvals research pauses until your balance is above zero. Only the organization owner sees **Organization Settings** (Usage, Billing). If you're a member, ask the owner to top up or raise the cap. ## Track your usage Open **Organization Settings → Usage** to see consumption across your whole organization. The Usage page shows: * **Credit balance** — what you have left. * **Spent this period** — used since your billing period started. * **Credits by day** — daily consumption trend. * **By workspace and by user** — who and what is spending. * **Credit caps** — a monthly credit limit per workspace, counted from your billing day. Leave it empty for no limit. ## Running low? Top up Buy credit packs anytime from **Billing**. Top-up credits carry over from month to month. | Pack | Price | | - | - | | 100 credits | \$39 | | 300 credits | \$99 | | 600 credits | \$179 | ## Good to know * A reply that pulls data does more thinking, so it costs more — hover the credit icon to see the breakdown. * Unused plan credits roll over — each billing period's allowance is added on top of your remaining balance, and top-up credits stay too. * The Usage page breaks consumption down by workspace and by user, so you can see who's spending. * Inviting your first teammate adds 200 bonus credits to your organization, once per organization. You'll see the offer as **Invite a team member, get 200 credits** in the chat. See [Invite teammates](/workspaces/invite-teammates). ## Related How the agent builds and renders ad creatives. Manage your subscription and payment method. # Reports Source: https://help.get-ryze.ai/agent/reports Ask your AI marketer for a report — it pulls the numbers and builds a deck you can download and send, or a live dashboard you share by link. Prefer video? Watch the [Reports guide](/guides/reports). Reports are write-ups your AI marketer builds from your live data — spend by channel, ROAS, conversions, trends, an executive summary. Instead of a wall of chat, you get a structured page you can share. Find them under **Reports** in the sidebar, in the **AI Marketer** group. ## Two kinds of reports * **Deck** — a slide-style report with a fixed snapshot of the numbers. Download it as a PDF, email it, or share it by link. * **Dashboard** — a live view that pulls fresh data from your connected accounts. Click **Refresh data** to update it. Dashboards are shared by link only — they can't be exported to PDF. ## Generate a report Click **Generate Report** and you land in a chat with the agent. It tells you what kinds of reports it can build, asks what to cover, then pulls the data and builds it. Want a starting point? Click **View templates** to pick a ready-made deck or dashboard. See [Templates](/agent/templates). You don't have to use the button — just ask the agent for a report in any chat ("put together a May performance report"). When it has the numbers, it builds the report and gives you a link to open it. The agent only builds the report once it has real data from your connected accounts — it won't invent metrics. Connect your ad accounts and analytics first so it has something to pull. ## Work with a report From the top of a report you can: * **Download PDF** (decks) — render the report to a clean, branded PDF. * **Refresh data** (dashboards) — pull the latest numbers. * **Share** — see below. * **Update Report** — opens a chat where the agent sums up the report's sections and asks what to update: fresh numbers, specific sections, or something else. To rename or delete a report, use the menu on its row in the Reports list. ## Share a report Click **Share**. Decks offer two options; dashboards go straight to the link. ### Share via Email (decks) Enter one or more addresses, separated by commas, and click **Send**. Each recipient gets the report as a PDF attachment. * **Also add recipients to this workspace** — adds each recipient as a member of this workspace so they can sign in and see your reports directly. Leave it off to just send the PDF without giving access. Adding someone to the workspace gives them access to everything in it, not just this report. ### Share by Link * **Anyone with the link** — turn it on and anyone with the link can open the report, no sign-in needed. With it off, only workspace members can open it. * **Copy link** — copy the link to send it anywhere. * **Reset link** — create a new link; the old one stops working. * You can also invite people by email from the same dialog — they join this workspace with full access. Share a dashboard once it has finished loading — the link shares the views that were open at that moment. ## Related Have the agent build a report on a recurring schedule. How agent work is billed. # Scheduled Tasks Source: https://help.get-ryze.ai/agent/schedules Have the agent run a task on a repeating schedule or once at a specific time, and send you the result — a weekly recap, a daily spend check, or a one-off reminder before a sale ends. Prefer video? Watch the [Scheduled tasks guide](/guides/schedules). Set a task once and Ryze runs it on its own — either **repeating** (every day, week, or month) or **one-time** at a specific moment in the future. Each run does the work in a fresh chat and sends you the result by email or Slack, so the report is waiting for you instead of being something you have to go pull. One-time tasks are great for reminders and one-off checks — "pull this report tomorrow at 9am", or "check spend after the sale ends Friday". After a one-time task runs, it's marked **Completed** and won't run again. Find it under **Schedules** in the sidebar, in the **AI Marketer** group. ## Create a scheduled task Click **Create with Agent** and just say what you want in chat. The agent briefly explains how scheduled tasks work, asks a few questions to nail down what to do and when it should run, then creates the schedule for you. Prefer a starting point? Click **View templates** to browse ready-made automations and build one with the agent. See [Templates](/agent/templates). The agent also offers this on its own — ask a question you'll clearly want answered again next week and it suggests a recurring task, or mention a specific moment ("check this after the sale ends Friday") and it suggests a one-time task for that time. **Describe the task as one instruction to carry out now**, not as a routine. The cadence already lives in the schedule, so "Produce a concise paid-media report for yesterday, compared with the prior day and the same weekday last week" is clearer for the agent — and for anyone reading the task later — than "Every morning, produce a concise paid-media report…". New tasks are **active as soon as they're created**. Runs are billed per AI step like any agent work (see [Credits & Usage](/agent/credits)), and the agent can use every tool it has access to — including changing or deleting things in your connected accounts. Write the task carefully and use at your own risk. ## What happens on each run When a schedule fires, Ryze: 1. **Starts a fresh chat** and runs your task as the agent. 2. **Writes the result** — the agent does the work and ends with a short recap: the verdict and the key numbers. 3. **Sends the recap** to the task's recipients — by email, to Slack channels, or both — with a link to open the full chat. The message is a short headline. The full reasoning and detail live in the chat behind the link. Scheduled-run chats are read-only — they're a record of what the agent did, not a conversation you continue. To change what runs, edit the task. **Replies to the result email don't reach the agent.** When a run finds a change that needs your sign-off — a budget, bid, targeting, keyword, creative or content change — it files an approval card instead of asking you in the email. Open **Home → Needs you** or the **Inbox** and click **Approve** or **Reject** there (see [Inbox and approvals](/agent/approvals)). To give the agent new instructions, start a new chat or edit the task. If there's no active subscription, your organization is out of credits, or the workspace has reached its monthly credit cap, the run is skipped and the task shows why. ## Manage a task Use the **Search scheduled tasks** box to find a task. Open any task to see its instructions, schedule, next run, and recent runs. * **Run now** — fire the task immediately. For a one-time task this is a one-off extra run — it doesn't use up the scheduled time, which still fires as planned. Once a one-time task is **Completed**, **Run now** is no longer available. * **Toggle (Active / Paused)** — pause or resume a repeating schedule. Paused tasks don't run and don't bill. (One-time tasks show **Completed** once they've run.) * **Refine with Agent** — opens a chat where the agent sums up the task and asks what you'd like to change — instructions, timing, or something else. It changes nothing until you answer. * **Edit** — change the task yourself: * **Name** and **Task** — the instructions the agent runs each time. Write it like a prompt: what to check, what to report. * **When should this run?** — **On a repeating schedule** (every day, week, or month, at the time and timezone you choose) or **Once, at a specific time** (it must be in the future and runs exactly once). * **Recipients** — **Slack channels** and **Email recipients** that get the result of each run — up to 20 email addresses and 20 Slack channels per task. For a private Slack channel, invite @Ryze AI there first. **Also add recipients to this workspace** gives each email address a seat in the workspace, with access to everything in it. * **Delete** — stops all future runs and removes the task's run history. This can't be undone. ## Related How runs are billed. Improvements the agent proposes on its own. # Templates Source: https://help.get-ryze.ai/agent/templates Ready-made tasks, report decks and dashboards for the agent — pick one instead of writing the prompt yourself. Open **AI Marketer → Templates** in the sidebar. Each template is a ready prompt for the agent, built on your workspace's live data. ## Find a template * Tabs across the top: **All**, **Monitor**, **Create**, **Optimize**, **Automate**, **Report**. * Platform filters on the right — Google Ads, Meta Ads, Google Analytics, Search Console and others — narrow the list to templates for that platform. Click a filter again to clear it. ## Three kinds of templates **Task templates** — click the card (or its arrow) and the agent panel opens and starts working on that prompt right away. This uses credits like any message (see [Credits & Usage](/agent/credits)). To change the prompt first, click the copy icon, paste the prompt into **New chat**, edit it, then send. **Deck templates** — presentation-style reports in the **Report** section: **Monthly Client Report**, **Marketing Audit**, **Quarterly Business Review**, **Creative Performance Review**, **SEO Audit**, **Post-Click Teardown**, **Competitor Landscape**, **Media Plan & Forecast** and **New Client Proposal**. Open one and click **Build with agent**: the agent pulls this workspace's live data and builds your version in [Reports](/agent/reports). **Copy prompt** copies the brief so you can adjust it. **Dashboards** (the **Monitor** tab) — for example **Organic Traffic Overview**, **AI Traffic Overview**, **Paid Ads Overview**, **All Accounts Overview**. Click **Use template** to create the dashboard in Reports once the platforms it needs are connected. If a required source isn't connected yet, the button says **Connect …** and takes you to [Integrations](/integrations/overview). ## Not sure where to start? Open a **New chat**. In the empty chat, pick an action chip — **Launch a campaign**, **Make creatives**, **Build a deck**, **Design a dashboard** or **Automate routine** — to see matching templates. For campaigns, decks, dashboards and automations, the first card (**Plan a campaign with me**, **Plan a deck with me**, **Design a dashboard with me**, **Plan automations with me**) makes the agent interview you first — your goal, budget and audience, who the deck is for, what you check every week — and then build it with you. See [Chat with the AI Marketer](/agent/chat). Want a template to run on its own every week? Copy its prompt into a [scheduled task](/agent/schedules). # Search and Ads Performance Source: https://help.get-ryze.ai/analytics/performance Live dashboards for your organic search (last 28 days) and your ad accounts (last 30 days), under Analytics in the sidebar. Both dashboards live under **Analytics** in the sidebar and pull data from your connected accounts. In the sidebar they're called **Search Performance** and **Ads Performance**; each page opens with the title **Dashboard**. Click **Refresh** at the top to pull the latest numbers; the line under the title shows when they were last updated. You can refresh again 5 minutes after the last refresh — until then the button is greyed out and reads **Refresh in 5m**. **Analytics → Web Analytics** is a different page: the dashboard of the Ryze Pixel on your site. See [Ryze Pixel](/paid-ads/ryze-pixel). ## Search Performance Open **Analytics → Search Performance**. It's part of the SEO plans, covers the last 28 days, and needs [Google Search Console](/integrations/google-search-console) — without it the page asks you to connect it. Three tabs: * **SEO** — four numbers on top: **Impressions · 28 D**, **Organic Clicks · 28 D**, **Domain Rating** and **Health Score** (from your latest Technical Audit). Below them: clicks, impressions and position over time, **Clicks by Country**, **Position Distribution** (Top 3 / 4–10 / 11–20 / 21+), **Branded vs Non-branded** and **Authority & Backlinks**. With Google Analytics connected you also see **AI Traffic** and **AI Landing Pages**. * **GEO** — how AI assistants answer your buyers' questions and whether they name you. Needs Google Analytics. This is the same view as **Analytics → AI Visibility** — see [AI Visibility](/seo/ai-visibility). * **Content** — how your published articles perform: published count, clicks, impressions, how many are indexed and ranking, and a table per article. ## Ads Performance Open **Analytics → Ads Performance**. It's part of Paid Ads and shows the last 30 days across your connected ad accounts. If none are connected, click **Open Integrations** — see [Integrations](/integrations/overview). Use the account selector at the top to choose which accounts to include — up to 30. Four tabs: * **Overview** — **Spend**, **Results**, **Best CPA** and **Clicks**; three trend charts (**Spend & ROAS**, **Conversions & rate**, **Clicks & CTR**); **ROAS by day & hour** and **Spend by day & hour** (hourly data from Google and Meta only); **Channels**; **Top movers**; **Cost per conversion**. * **Campaigns** — **Active campaigns**, **Best CPA**, **Conversion rate** and **Avg CPC**; **Daily conversions by platform** and **Daily spend by platform**; the **Top campaigns** table. * **Creatives** — your running ads with spend, CTR, CPC and results, as cards or a table. Needs a Meta or LinkedIn account with running ads. * **Portfolio View** — every selected account side by side: **Spend by account**, **ROAS by account**, **CPA by account**, **Account funnels** (impressions → clicks → conversions per account) and the **All accounts** table. If accounts report in different currencies, totals are shown in one currency and the page tells you which accounts are left out. To dig into a number, ask the agent in **New chat** — it reads the same data. See [Chat with the AI Marketer](/agent/chat). # Billing FAQ Source: https://help.get-ryze.ai/billing/faq Plans, trials, invoices, cancellation, credits and refunds — how billing works at Ryze. Everything here follows our [Refund and Cancellation Policy](https://www.get-ryze.ai/refund-policy). If anything below seems to disagree with it, the policy wins — tell us at [support@get-ryze.ai](mailto:support@get-ryze.ai) so we can fix the page. Open **Organization Settings → Billing** and click **Cancel plan** under the plan. Ryze shows a few screens first — click **Continue cancellation**, **Cancel anyway** or **I still want to cancel** to go on, pick a reason, then click **Confirm cancellation** on **Are you sure?**. Access stays until the end of the paid period, and the Billing page shows the date it ends. On an SEO plan with several websites, cancelling stops SEO for all of them — to drop only one website, email [support@get-ryze.ai](mailto:support@get-ryze.ai). Changed your mind? Click **Resume subscription** before the end date. See [Manage your subscription](/billing/manage-subscription#cancel-your-subscription). Yes. Unless you cancel before the trial ends, the plan you selected starts automatically and the card on file is charged for the first billing period. **Do not rely on a reminder email before that charge — note the date when you start.** The trial end date is shown on **Organization Settings → Billing**. To avoid the charge, cancel before that date — auto-renew turns off and the trial simply ends. A trial requires a valid payment method. If your organization already had a subscription to that product, a new one starts without a trial. Plans with a free trial charge a one-time \$1 setup fee when the trial starts. It adds 250 starter credits to your balance so the agent can begin work immediately. It isn't refunded, including if you cancel during the trial. Yes. Paid Ads and Agency come with a 7-day free trial, SEO Starter with a 3-day free trial — each with a one-time \$1 setup fee. The exact trial length is shown before you confirm. Yes. Paying annually saves 30% in the first year; after that, the annual plan renews at the regular price. The exact amount is shown before you confirm. Subscription charges aren't refunded once processed — including partial periods, unused time, or a trial that converted because it wasn't cancelled. To stop future charges, cancel from **Billing → Cancel plan**; you keep access until the period ends. We do correct duplicate charges and billing errors: email [support@get-ryze.ai](mailto:support@get-ryze.ai) within 30 days with the account email, charge date, amount and a short description. Please contact us before opening a bank dispute. Full terms: [Refund and Cancellation Policy](https://www.get-ryze.ai/refund-policy). Two charges in one month usually mean two different products (for example Paid Ads at $89 and SEO Starter at $129), or a second subscription created under another email. Failed card attempts can also show on some statements but don't collect money. Check **Organization Settings → Billing** for the subscriptions on this organization; if you see a duplicate you didn't intend, email [support@get-ryze.ai](mailto:support@get-ryze.ai) with the two dates and amounts within 30 days and we'll correct it. Yes. Credits never expire: unused plan credits and top-up credits carry over from month to month, and each period's allowance is added on top of your balance. Annual plans get the whole year's credits at the start of the year. See [how many credits each plan includes](/plans/overview#credits) and [Credits & Usage](/agent/credits). Monthly or annually, on the date you subscribed, and automatically renewed for periods of the same length until you cancel. Prices are in USD and may not include tax. Your billing date also anchors the SEO engine's monthly content cycle. It depends on the plan: * **Paid Ads ↔ Agency, monthly ↔ yearly:** on **Organization Settings → Billing**, click **Switch → Switch now** on the plan you want. The switch is immediate: the prorated difference is charged to your card now and the plan renews at the new price. If you're on a free trial, switching ends the trial and starts billing now. You need a card saved under **Invoices & payment method**. * **SEO Starter → Traffic Printer:** click **Unlock Mentions** on the Traffic Printer card. Your card is charged today for the rest of the current period; it renews with your SEO subscription and covers all your websites. * **Other SEO changes** (Traffic Printer → SEO Starter, monthly ↔ yearly): email [support@get-ryze.ai](mailto:support@get-ryze.ai) and we'll change it for you. Switching from annual to monthly, or cancelling an annual plan mid-term, doesn't refund the unused part of the annual charge. See [Switch your plan](/billing/manage-subscription#switch-your-plan). We retry the card and notify you. The plan shows *Payment failed — update your card to keep access.* and your workspaces show *Your last payment failed*. Click **Update payment method** on the plan (or in that message) to update the card and keep things running. If payment still isn't received, the subscription is suspended and then cancelled; reactivating after non-payment may require settling the outstanding balance. Billing lives at the **organization** level, not the workspace: open **Organization Settings → Billing**. Only the organization owner sees it — if you were invited as a member, ask the owner. Open **Billing** in your organization settings and click **Invoices & payment method** on a subscription. This opens the billing portal, where you can view and download every invoice and receipt. Invoices are also emailed to your billing address after each successful payment. Yes. Invoices stay available after cancellation; open **Billing → Invoices & payment method** as long as you can sign in. If you no longer have access, email [support@get-ryze.ai](mailto:support@get-ryze.ai) with the email you paid under and we'll send the links. In the billing portal (**Billing → Invoices & payment method**), update your billing details. Company name, address, and VAT/tax ID appear on all future invoices. Past invoices aren't reissued automatically — contact support if you need one corrected. Go to **Billing → Invoices & payment method** and update your payment method in the billing portal. No. Your billing details in the portal can use a different email from your account login. We bill a fixed amount in USD. The difference is your card issuer's currency conversion plus any foreign-transaction fee — not an extra charge from Ryze. The USD invoice in the billing portal is the accurate record. Articles published to your own site or CMS stay yours, and backlinks we placed on third-party sites aren't taken down. Ryze stops producing new work when the paid period ends. See [SEO FAQ](/seo/faq). Cancel your subscription first from **Billing → Cancel plan**, then open **Organization Settings → General** and click **Delete account**. See [Delete your account](/workspaces/delete-account). Email [support@get-ryze.ai](mailto:support@get-ryze.ai), or send a message from the app: click **Share Feedback** (the speech-bubble icon in the top bar, or in the account menu), pick a **Type**, write your message and click **Send**. Every message gets a reply by email. There's no ticket portal; the email thread is your ticket, so reply in the same thread to keep the history together. To check whether Ryze is up, open the **Help & support** button at the bottom-right → **System status**, or [status.get-ryze.ai](https://status.get-ryze.ai). More ways to get help: [Get help and send feedback](/introduction#get-help-and-send-feedback). ## Related * [Manage your subscription](/billing/manage-subscription) * [Credits & Usage](/agent/credits) * [Refund and Cancellation Policy](https://www.get-ryze.ai/refund-policy) # Invoices & Payment Method Source: https://help.get-ryze.ai/billing/invoices-and-payment Find your invoices and update your payment card. Invoices, your payment card and billing details are behind one button: **Invoices & payment method**. ## Open Billing Go to **Organization Settings → Billing** ([open Billing](https://reports.get-ryze.ai/settings/billing)). You'll see plan cards in three sections — **Paid Ads**, **Agent** (credit packs) and **SEO**. The plan you're on shows its status and date (**Trial ends**, **Renews** or **Cancels**). ## Download invoices 1. Click **Invoices & payment method** on the plan you're on. 2. The billing portal opens. 3. View and download any invoice or receipt as a PDF. Invoices are also emailed to your billing address after each successful payment. ## Update your payment card Click **Invoices & payment method**, then update your payment method in the billing portal. The new card applies to your next charge. If a payment failed, the plan shows **Update payment method** instead — click it to open the same portal. ## Add company or VAT details In the billing portal, edit your billing details to add a company name, address, or VAT / tax ID. These appear on all future invoices. ## Related Switch your plan or cancel. Common billing questions. # Manage Your Subscription Source: https://help.get-ryze.ai/billing/manage-subscription Switch plans, upgrade to Traffic Printer, start, resume or cancel a plan, and fix a failed payment — all from the Billing page. Everything about your subscription lives on the **Billing** page in your organization settings. ## Open Billing Go to **Organization Settings → Billing** ([open Billing](https://reports.get-ryze.ai/settings/billing)). Only the organization owner sees this page. The page has three sections: * **Paid Ads** — the Paid Ads and Agency plans. * **Agent** — credit packs you can buy anytime. * **SEO** — the SEO Starter and Traffic Printer plans. Each plan card has a **Monthly / Yearly** switch. The plan you're on shows a status badge (**Trial**, **Active**, **Payment failed**…) and its date: **Trial ends**, **Renews** or **Cancels**, followed by the date. ## Switch your plan * **Paid Ads ↔ Agency, monthly ↔ yearly:** on the plan you want (use the **Monthly / Yearly** switch to pick the period), click **Switch**, then **Switch now**. The switch is immediate: the prorated difference is charged to your card now and the plan renews at the new price. **If you're on a free trial, switching ends the trial and starts billing now.** You need a card saved under **Invoices & payment method** first. * **SEO Starter → Traffic Printer:** click **Unlock Mentions** on the Traffic Printer card. See [Upgrade to Traffic Printer](#upgrade-seo-starter-to-traffic-printer). * **Other SEO changes** (Traffic Printer → SEO Starter, monthly ↔ yearly): email [support@get-ryze.ai](mailto:support@get-ryze.ai) and we'll change it for you. ## Upgrade SEO Starter to Traffic Printer Click **Unlock Mentions** on the Traffic Printer card. It adds 50+ high-quality backlinks (DR 30+), 3 editorial guest posts and 100+ PR placements every month. The difference is $470/month or $5,640/year for each website on your SEO plan. You're charged today for the rest of the current period; after that it renews together with your SEO subscription and covers all your websites. If you're on the SEO Starter free trial, unlocking Mentions ends the trial and starts your subscription today. The amount is shown on the button before you pay. ## Other buttons on your plan * **Start subscription now** — shown during a free trial. It ends the trial right away and charges the plan price today. Confirm with **Yes, start now**, or click **Keep my trial**. * **Resume subscription** — shown after you cancel (the card says **Cancels** and the date; on a trial, **Trial ends** and the date) and on a paused plan. Click it to keep the plan; nothing else changes. * **Paused** — a paused plan shows *Subscription paused — resume anytime, your setup stays saved.* Click **Resume subscription** to restart billing. * **Payment failed** — the card shows *Payment failed — update your card to keep access.* Click **Update payment method** to fix it. * **Complete payment** — finishes a checkout that still needs your confirmation (status **Pending**). Status badges you may see: **Trial**, **Active**, **Payment failed**, **Canceled**, **Pending**, **Expired**, **Unpaid**, **Paused**. ## Cancel your subscription 1. Click **Cancel plan** under the plan. 2. Ryze shows what's running on your account and asks a few questions. To keep cancelling, click **Continue cancellation**, **Cancel anyway** or **I still want to cancel** on each screen. 3. Pick a reason (and add details if you like). 4. On **Are you sure?**, click **Confirm cancellation**. Your subscription stays active until the end of the paid period — the card then shows **Cancels** and the date your plan ends. You won't be charged again after that. If you cancel during a trial, auto-renew turns off and the trial simply ends on the date shown under **Trial ends**. Changed your mind? Click **Resume subscription** on the plan before that date. ### Cancelling SEO for one website only **Cancel plan** on an SEO subscription ends SEO for every website on it — with several websites, the last screen says so. To stop SEO for one website only, or to move your SEO plan to a different website, email [support@get-ryze.ai](mailto:support@get-ryze.ai) from your account address and we'll adjust the subscription for you. ## Invoices and payment card Click **Invoices & payment method** to download invoices, update your card, or add company and VAT details. See [Invoices & Payment Method](/billing/invoices-and-payment). ## Delete your account Cancelling keeps your account. To remove the organization and everything in it, see [Delete your account](/workspaces/delete-account). # Referral program Source: https://help.get-ryze.ai/billing/referral-program Share Ryze and earn 30% of every payment for 12 months from each person you refer Every Ryze user has a personal referral link and code. When someone you refer becomes a paying customer, you earn **30% of every payment they make during their first 12 months** — automatically, on every invoice. ## Share your link Click the **gift icon** (**Refer & earn**) in the top bar, or open the workspace menu at the top and choose **Refer & earn**. Your personal link looks like `reports.get-ryze.ai/login?ref=yourcode`. Share it anywhere — DMs, posts, communities. You can also send invites by email straight from the dialog. Anyone who opens your link is tracked for 30 days. Once they subscribe, every payment they make earns you 30% for their first 12 months. ## How tracking works * **By link** — opening your invite link marks the visitor's browser for 30 days. If they sign up and later subscribe, the referral is yours, even if they pay weeks after the click. * **By code** — if someone signed up without your link, they can still credit you: **gift icon → Apply referral** and enter your code. This only works before their first payment. ## When you earn * Commissions accrue on **real payments only**. Free trials don't generate anything until they convert to a paid subscription. * You earn on **every payment** — monthly renewals included — for the referral's first 12 months. * If a referred customer is refunded or cancels, the related commission is adjusted automatically. ## Getting paid Payouts are handled through our partner portal: 1. Go to [ryze.tolt.io](https://ryze.tolt.io) (or click **Partner portal** on the **Past referrals** tab of the referral dialog) and sign in with the same email you use for Ryze. 2. Set up your payout method in the portal. 3. Commissions are paid out monthly. The portal also shows your full history: clicks, sign-ups, and every commission with its status. No — self-referrals are blocked. The code is for people you invite. Make sure they used your link before signing up, or applied your code before their first payment. If they did and you still don't see them, [email support](mailto:support@get-ryze.ai) with their sign-up email and we'll check the attribution. A trial shows up as a sign-up, but commissions only start once the trial converts into a paid subscription. No limit on referrals. Email invites from the dialog are capped at 20 per day to prevent abuse — your link itself has no limits. You can invite the same email address once per 24 hours. Yes — the same program is open to resellers and creators. See the public [affiliate program page](https://www.get-ryze.ai/affiliate-program) for details. # ChatGPT Source: https://help.get-ryze.ai/chatgpt/connect Add Ryze as a custom connector in ChatGPT and chat with your ad data. Takes about two minutes. Ryze works inside ChatGPT. Once connected, you can ask ChatGPT about your Google Ads and Meta data in plain language — no dashboards, no exports. You'll need a ChatGPT plan that supports apps and connectors (Plus, Pro, or Business), and **Developer mode** turned on — the steps below cover it. You also need an active Ryze plan or free trial (Paid Ads, Agency or an SEO plan). Without one, ChatGPT can list your workspaces and connect platforms, but every other Ryze tool replies that a subscription is required, with a link to start your trial or fix your payment. ## Your connector URL You'll need this when adding Ryze to ChatGPT: ``` https://connector.get-ryze.ai/mcp ``` ## Add Ryze as a connector In ChatGPT, open **Settings**, then click the **Apps** tab on the left. Open the Apps tab in ChatGPT settings On the Apps page, find **Advanced settings**. The Apps page with Advanced settings Enable **Developer mode**. This is what lets you add a custom connector. Enable Developer mode Click **Create app** at the top. Click Create app * **Name** — enter `Ryze AI` * **MCP server URL** — enter `https://connector.get-ryze.ai/mcp` (keep **Server URL** selected, not Tunnel) * **Authentication** — choose **OAuth** * Tick **I understand and want to continue**, then click **Create** The New App form filled in ChatGPT opens a Ryze authorization page. Click **Sign in with Ryze AI**. Sign in with Ryze AI On the Ryze page **Connect your data sources to AI**, choose the workspaces ChatGPT can access (or keep **All workspaces**, up to 20 per connection), then click **Allow connection**. When exactly one workspace is selected, the page also shows **Connect your accounts**, so you can connect Google, Meta and other ad accounts right there first. You'll see a green **Ryze AI is installed** toast. The app page lists the connection details and the Ryze tools for the platforms connected in the workspaces you picked, plus Ryze's own tools (workspaces, connections, creatives and more). Platforms you haven't connected yet don't show tools until you connect them and refresh the app — see below. Ryze AI installed in ChatGPT ## New to Ryze? If you don't have a Ryze account yet, click **Sign up** on the Ryze sign-in page (*Create your account to connect Ryze AI to your assistant*). Enter your email and your website, click **Create account**, then type the code we email you. Ryze creates your workspace and takes you back to **Connect your data sources to AI**, where **Connect your accounts** lets you link Google, Meta and other ad platforms. Then click **Allow connection**. To use the tools, start your free trial in **Organization Settings → Billing**, or open the link ChatGPT shows when it says a subscription is required. ## Try it Start a **new chat** in ChatGPT and ask for what you want: > Pull the last 7 days of Google Ads spend and break it down by campaign. ChatGPT uses Ryze tools to answer. Always start a **new chat** after connecting or reconnecting. Existing chats won't pick up the connection. ## Connected a new platform after installing? ChatGPT saves the list of Ryze tools at the moment you install the app. Platforms you connect in Ryze afterwards (Google Ads, GA4, Search Console, WordPress…) don't appear in ChatGPT on their own, even in a new chat. To refresh the list: in ChatGPT open **Settings → Apps**, remove **Ryze AI**, install it again, then start a **new chat**. Reconnecting the platform on the Ryze side doesn't refresh ChatGPT's saved list. ## Next steps Control which actions the assistant can take on your accounts. Link Google, Meta, Analytics and more. Having trouble connecting? See the [FAQ](/claude/faq) or email [support@get-ryze.ai](mailto:support@get-ryze.ai). # Chrome Extension Source: https://help.get-ryze.ai/chrome-extension Check the AI visibility of any site right from your browser with the Ryze AI extension for Chrome, and what the monthly site limits are. The Ryze AI extension for Chrome shows AI visibility for any site you open: how often AI assistants mention it, the questions it comes up for, the pages they cite and the other sites named alongside it. ## Install and connect In Ryze, open the account menu at the bottom left and click **Chrome Extension**. It opens the extension in the Chrome Web Store — click **Add to Chrome**. Open the extension and click **Sign in**. Ryze opens in a new tab; log in if you aren't already. On **Connect the Ryze AI extension**, choose the **Workspace** the extension should use and click **Allow connection**. If you see "This link is missing the extension callback", open the extension and click **Sign in** again. If Ryze says you have no workspace yet, finish onboarding in the app first. ## Limits With any active Ryze subscription you can check 100 different sites a month; without one, 10. The count is per user, resets on the 1st of each month and is shown in the extension. Past the limit, the extension says **Monthly site limit reached** until the next month. For tracking your own brand across ChatGPT, Claude, Gemini and Perplexity over time, use [AI Visibility](/seo/ai-visibility) in the app. # How to connect Claude to Google Ads and Meta Ads (Ryze connector) Source: https://help.get-ryze.ai/claude/connect Add Ryze as a custom connector in Claude and chat with your ad data. Takes about 90 seconds. Prefer video? Watch the [Ryze inside Claude guide](/guides/connect-claude). Ryze works inside Claude. Once connected, you can ask Claude about your Google Ads and Meta data in plain language — no dashboards, no exports. ## Before you start * **Any Claude plan works** — Free, Pro, Max, Team and Enterprise all support custom connectors. On the Free plan you can add one custom connector, so remove another custom connector first if you already have one. * **Team or Enterprise?** An organization Owner adds Ryze once in Claude's **Organization settings → Connectors → Add → Custom → Web** with the URL below. After that, each member opens **Customize → Connectors**, finds **Ryze AI** and clicks **Connect** — skip to step 6. * **You need an active Ryze plan or free trial** (Paid Ads, Agency or an SEO plan). Without one, Claude can list your workspaces and connect platforms, but every other Ryze tool replies that a subscription is required, with a link to start your trial or fix your payment. ## Your connector URL You'll need this when adding Ryze to Claude: ``` https://connector.get-ryze.ai/mcp ``` ## Add Ryze as a connector Go to [claude.ai](https://claude.ai), click your profile avatar at the **bottom-left**, then choose **Settings**. Open Settings in Claude In Settings, open the **Connectors** tab. Claude shows that connectors have moved to **Customize** — click the link to open **Customize → Connectors**. Open the Customize panel On the Customize page, with **Connectors** selected, click **+ Add** at the top-right and choose **Add custom connector**. (In some versions of Claude this is a **+** button next to *Connectors*.) * **Name** — enter `Ryze AI` * **MCP server URL** (called **Remote MCP server URL** in some versions) — enter `https://connector.get-ryze.ai/mcp` Click **Continue** (or **Add**) at the bottom-right of the dialog. Click **Connect** on the new Ryze AI connector. Claude opens the Ryze page **Connect your data sources to AI**. Sign in if asked. Under **Workspaces**, choose the workspaces Claude can access — all are selected by default (**All workspaces**), up to 20 per connection. Then click **Allow connection**. When exactly one workspace is selected, the page also shows **Connect your accounts**, so you can connect Google, Meta and other ad accounts right there before you allow access. You'll see a green **Connected to Ryze AI** toast. The connector now lists the Ryze tools for the platforms connected in the workspaces you picked, plus Ryze's own tools (workspaces, connections, creatives and more). Platforms you haven't connected yet don't show tools until you connect them and reload the connector — see the [FAQ](/claude/faq). Shortcut: open [claude.ai/customize/connectors](https://claude.ai/customize/connectors) directly and start at step 3. Or, in Ryze, open **Integrations → Claude MCP** and click **Open Claude MCP** — it copies the connector URL and opens Claude's add-connector dialog. ## New to Ryze? If you don't have a Ryze account yet, click **Sign up** on the sign-in page that opens in step 7 (*Create your account to connect Ryze AI to your assistant*). Enter your email and your website, click **Create account**, then type the code we email you. Ryze creates your workspace and takes you back to **Connect your data sources to AI**, where **Connect your accounts** lets you link Google, Meta and other ad platforms. Then click **Allow connection**. To use the tools, start your free trial in **Organization Settings → Billing**, or open the link Claude shows when it says a subscription is required. ## Try it Start a **new chat** in Claude and ask for what you want: > Pull the last 7 days of Google Ads spend and break it down by campaign. Claude uses Ryze tools to answer. Always start a **new chat** after connecting or reconnecting. Existing chats won't pick up the connection. ## Next steps Control which actions Claude can take on your accounts. Link Google, Meta, Analytics and more. Having trouble connecting? See the [FAQ](/claude/faq) or email [support@get-ryze.ai](mailto:support@get-ryze.ai). # FAQ Source: https://help.get-ryze.ai/claude/faq Common questions about connecting Ryze to Claude. Any plan — custom connectors work on Claude **Free, Pro, Max, Team and Enterprise**. On the Free plan you can add one custom connector, so remove another custom connector first if you already have one. On **Team** and **Enterprise**, an organization Owner adds Ryze once in Claude's **Organization settings → Connectors → Add → Custom → Web** (URL `https://connector.get-ryze.ai/mcp`). After that, each member opens **Customize → Connectors**, finds **Ryze AI** and clicks **Connect**. The Ryze tools need an active Ryze plan or free trial (Paid Ads, Agency or an SEO plan). Without one, Claude can still list your workspaces and connect platforms, but every other tool replies that a subscription is required, with a link. Start your free trial — or update your card if a payment failed — in **Organization Settings → Billing** (or open the link Claude shows), then retry in the same chat. It's the same for everyone: ``` https://connector.get-ryze.ai/mcp ``` Paste it into the **MCP server URL** field when you add the custom connector. See [Connect Ryze to Claude](/claude/connect). 1. In Claude, go to **Customize → Connectors** and remove the Ryze connector. 2. Add it again following [Connect Ryze to Claude](/claude/connect). 3. Open a **new chat** and try again. This error only happens on the legacy Ryze connector. Remove every Ryze connector in Claude's **Customize → Connectors**, add the current one at `https://connector.get-ryze.ai/mcp` following [Connect Ryze to Claude](/claude/connect), and start a **new chat**. If you're still on the old platform, email [support@get-ryze.ai](mailto:support@get-ryze.ai) and we'll move you over. * Make sure the platform shows **Connected** on the **Integrations** page. * Confirm you connected it in one of the **workspaces you picked** when connecting Claude. If you picked several, name the workspace (client) you mean in chat. * Start a **new chat** — newly connected platforms don't appear in older chats. No — not without your say-so. Read-only tools just pull data. Write and delete tools can be set to **Needs approval**, so Claude asks before making any change. See [Permissions & Approvals](/claude/permissions). Yes. Create a workspace for that client, connect their accounts in it, and include that workspace when you connect Claude. Each workspace is isolated, so you can manage multiple clients from one Ryze account — and one Claude connection can cover up to 20 of them. Yes — connect them all to a single workspace and connect Claude to it. A workspace supports multiple accounts per platform, and you switch between them just by naming one in chat. See [Managing Multiple Accounts](/integrations/managing-multiple-accounts). For Claude.ai, ChatGPT and Grok Bot you don't need a key: add the URL `https://connector.get-ryze.ai/mcp` and approve access in the browser. If an older guide asked you for a "Ryze key" for Claude.ai, ignore it and follow [Connect Ryze to Claude](/claude/connect). For Claude Code, your own agent or scripts, create a key in **Workspace Settings → Profile → API keys → Create key** and send it as `Authorization: Bearer rk_live_…`. See [Ryze API for agents](/agent-api). Claude caches the connector's tool list when you add the connector, so platforms connected afterwards (Meta, TikTok, LinkedIn, GA4…) don't appear. Remove the Ryze connector in Claude (**Customize → Connectors**), add it again, then start a **new chat**. Reconnecting the platform on the Ryze side doesn't refresh Claude's cache. Claude is still pointing at the legacy connector. Remove **every** Ryze connector in Claude's **Customize → Connectors**, add the current one at `https://connector.get-ryze.ai/mcp` and start a new chat. The same applies to ChatGPT — see [Connect Ryze to ChatGPT](/chatgpt/connect). Yes — one connection can cover up to 20 workspaces. On the Ryze page **Connect your data sources to AI**, open **Workspaces** and tick the ones you want (all are selected by default, shown as **All workspaces**), then click **Allow connection**. In chat, name the workspace (client) you mean — Claude passes it to every tool. To add or remove workspaces later, remove the Ryze connector in **Customize → Connectors**, add it again and change the selection. No. Everything works in the Ryze web app at reports.get-ryze.ai — chat, reports, creatives, scheduled tasks. Claude and ChatGPT are optional front-ends. The connector works on any Claude plan, including Free; a paid Claude plan is billed by Anthropic separately from your Ryze subscription. Your own Anthropic key covers the AI steps of chat only. Work the agent does on the Ryze side — agent tasks, scheduled tasks, Approvals it applies, and fixed-cost tools like creative generation — runs on Ryze and draws credits. A Claude subscription can't be used as a key; only an Anthropic API key can. See [Credits & usage](/agent/credits). Through the Claude or ChatGPT connector itself, Ryze charges no AI steps — see [Through Claude or ChatGPT](/agent/credits#through-claude-or-chatgpt) for what uses credits there. Chats live where you ran them. Web-app chats are per workspace — switch workspace and you'll see a different history. Chats run from Claude or ChatGPT are stored in that tool's own history, not in Ryze. Chats from the legacy platform did not carry over to the new one. It's a transient session error, not an account problem: retry the message, then start a new chat, then disconnect and reconnect the Ryze connector. If it keeps happening across new chats, check **Billing** — a past-due subscription or an empty credit balance shows up the same way. Very long chats can also hit a size limit; start a fresh chat per task. # Permissions & Approvals Source: https://help.get-ryze.ai/claude/permissions Control exactly what Claude can do with your connected accounts. Claude can only touch your data through the tools Ryze exposes. You decide which ones run automatically and which need your approval — right inside Claude's connector settings. ## Read vs write tools Ryze tools come in two kinds: * **Read-only tools** — pull data (spend, ROAS, reports, keywords). Safe; nothing changes in your accounts. * **Write / delete tools** — make changes (create or edit campaigns, apply recommendations, generate creatives). These can affect live accounts. Ryze tool permissions in Claude, split into read-only and write/delete tools ## Set approval per tool In Claude, open **Customize → Connectors → Ryze AI** ([claude.ai/customize/connectors](https://claude.ai/customize/connectors)). Under **Tool permissions** you can: * Leave **read-only tools** on automatic — they just run. * Set **write / delete tools** to **Needs approval**, so Claude asks before it changes anything. Keep write and delete tools on **Needs approval**. You'll see exactly what Claude wants to do, and you approve it with one click — nothing happens to your live campaigns without your say-so. ## Disconnecting To revoke access entirely, open **Customize → Connectors → Ryze AI** in Claude and click **Disconnect**. Claude immediately loses access to every workspace and tool. ## Related Set up the connector in 90 seconds. Common connection questions. # Grok Bot Source: https://help.get-ryze.ai/grok/connect Ryze AI is a built-in connector in Grok Bot. Search for Ryze AI, click Add, sign in. No custom MCP server to configure. Ryze AI is listed in Grok Bot's app directory. Search for it, click **Add**, and sign in. You don't need to add a custom MCP server or paste a URL. Once connected, you can ask Grok Bot about your Google Ads, Meta Ads, GA4, Search Console and store data in plain language. You need an active Ryze plan or free trial (Paid Ads, Agency or an SEO plan). Without one, Grok Bot can list your workspaces and connect platforms, but every other Ryze tool replies that a subscription is required, with a link to start your trial or fix your payment. ## Add Ryze AI In Grok Bot, open **Connect Apps**. The Connect Apps window in Grok Bot Type `Ryze AI` in **Search across apps and skills**, open **Ryze AI** (developer: Ryze AI), and click **Add**. The Ryze AI connector page in Grok Bot with the Add button Your browser opens Ryze. Sign in if asked, choose which workspaces Grok Bot can access (or **All workspaces**), then click **Allow connection**. The Ryze authorization page: pick workspaces and allow the connection You'll see **Authorization complete!** Click **Open Grok Bot** in the browser prompt, or **Return to Grok Bot**. Authorization complete, with the Return to Grok Bot link The Ryze AI page in Grok Bot now shows your account as **Connected** and lists the Ryze tools Grok Bot can call. Ryze AI connected in Grok Bot, with its tools enabled ## New to Ryze? If you don't have a Ryze account yet, click **Sign up** on the Ryze sign-in page that opens in step 3 (*Create your account to connect Ryze AI to your assistant*). Enter your email and your website, click **Create account**, then type the code we email you. Ryze creates your workspace and takes you back to **Connect your data sources to AI**, where **Connect your accounts** lets you link Google, Meta and other ad platforms. Then click **Allow connection**. To use the tools, start your free trial in **Organization Settings → Billing**, or open the link Grok Bot shows when it says a subscription is required. ## Try it Start a **new chat** in Grok Bot and ask for what you want: > Pull the last 7 days of Google Ads spend and break it down by campaign. Grok Bot uses Ryze tools to answer. Start a **new chat** after connecting or reconnecting. Existing chats may not pick up the connection. ## Added Ryze as a custom MCP server before? You don't need it anymore. Uninstall the custom server and add **Ryze AI** from **Connect Apps** instead, so you don't have two copies of the same tools. ## Next steps Control which actions the assistant can take on your accounts. Link Google, Meta, Analytics and more. Having trouble connecting? See the [FAQ](/claude/faq) or email [support@get-ryze.ai](mailto:support@get-ryze.ai). # Generating ad creatives Source: https://help.get-ryze.ai/guides/ad-creatives Generate ad creatives in your brand style, iterate by commenting directly on the image, and find every creative in Ads → My Creatives.