Agency OS - How-To Journeys

Five step-by-step procedures for running the dashboard end to end. Each step is one action, with a short clip of it happening live and what you should see next. Clips are recorded on seeded demo data, so no real client information appears.

1Connect a platform

Goal: a connected ad platform with data flowing into the dashboard. Admin~2 min
Before you start: have the login for the ad account you want to connect (Google Ads, Meta, GA4, etc.).
Sign in Open Connections Start the connect Authorize & pick account
1

Sign in

Open in app ↗

Enter your email and password, then click Sign In.

Signing in

You'll see your agency dashboard.

2

Open Connections

Open in app ↗

From the sidebar, open Connections and expand the platform you want.

Opening Connections

You'll see a card per platform with a green "connected" pill and last-sync time. Already-connected platforms list their accounts.

3

Start the connect

Open in app ↗

Click Connect Account (or + Add Account) and review the read-only consent.

Connect consent modal

You'll see what will happen and the permissions requested, then one button to continue to the provider.

4

Authorize, then pick the account

Sign in at the provider, then choose which account to connect and confirm.

Illustration: this screen only appears mid-redirect during a real provider sign-in, so it is recreated here.
Select account · Bloom Boutique ✓ · Summit Real Estate ✓ · "Connect 2 accounts"

You'll see the dashboard return to Connections; the first sync starts automatically and the account turns "Connected".

Done. The platform is connected and data begins syncing on its own.

2Set targets & alerts, then monitor

Goal: goals and threshold alerts in place, tracked from Home. Admin / Manager~3 min
Open Targets & Alerts Create a target Add an alert Monitor on Home
1

Open Targets & Alerts

Open in app ↗

Open Targets & Alerts to see your goals and their status dots.

Targets tab

You'll see targets grouped by client, each showing actual vs goal and a green (on track) or red (behind) dot.

2

Create a target

Open in app ↗

Click + Create Target, then set scope, platform, metric, condition, and value.

Creating a target

You'll see the new target appear in the list with its status dot.

3

Open the Alerts tab

Open in app ↗

Switch to the Alerts tab to see your threshold rules.

Alerts tab

You'll see a table of rules: client, platform, the rule (e.g. "cpc > 5"), and status.

4

Add an alert

Open in app ↗

Click + Add Alert, then choose platform, metric, condition, value, and how often to check.

Adding an alert

You'll see the rule added; it starts checking on its interval and notifies you when breached.

5

Monitor on Home

Open in app ↗

Go to Home and watch your KPIs against the goals you just set.

Home dashboard

You'll see spend, conversions, ROAS and more with trend lines and vs-last-month deltas.

6

Act on a fired alert

Open in app ↗

Open the bell in the top bar to read fired alerts; click View to jump to the rule.

Notifications panel

You'll see each alert with its message, client, and time, plus View and Dismiss.

Done. Targets and alerts are live, and you can track everything from Home.

3Build & share a client report

Goal: a report generated or scheduled, and the client invited to view it. Admin / Manager~3 min
Pick a client Generate or schedule Open the client Invite to portal
1

Open Reporting & pick a client

Open in app ↗

Open Reporting and choose a client from the filter (this enables Generate).

Reporting page

You'll see that client's metrics, charts, and per-platform scorecards update.

2

Generate it now

Open in app ↗

Click Generate Report, choose the sections to include and a delivery method.

Generate report

You'll see the report open in a new tab (browser) or download as a PDF.

3

Or schedule it

Open in app ↗

Switch to the Schedule tab to send a recurring PDF automatically.

Schedule report

You'll see name, frequency, time, sections, and recipients; Save Schedule sets it running.

4

Review the report

The report opens white-labeled with your agency's logo and colors. Use Print / Save as PDF to export.

Illustration of the print/PDF output.
Digital Marketing Report · cover, Performance Overview, Google Ads, Meta, GA4, SEO, All Campaigns

You'll see a clean, client-ready document with no "Agency OS" branding anywhere.

5

Open the client

Open in app ↗

Go to Clients and open the client you want to give access to.

Client detail

You'll see the client's summary, team members, and a Client portal access section.

6

Invite to the portal

Open in app ↗

Scroll to Client portal access, click Invite Client. Choose Email a magic link (client gets a one-click sign-in email) or Set a password (no email; you share the credentials directly). Enter name, email, and send.

Invite client

You'll see the contact appear with an Invited badge. Once they sign in it turns Active.

The client only ever sees their own data, read-only. They cannot change anything. See Journey 5 for the full client view.
Done. The report is ready to share and the client can view their dashboard.

4Onboard a client to the portal

Goal: a client contact has read-only access to their own dashboard, and you can revoke it if needed. Admin / Manager~2 min
Portal contacts see only their client's data, read-only. They cannot touch campaigns, targets, or settings.
Open client Portal section Click Invite Choose method Confirm Revoke if needed
1

Open the client

Open in app ↗

Go to Clients and click the client you want to give portal access to.

Clients page

You'll see the client list; click any row to open the client detail page.

2

Find the portal access section

Open in app ↗

On the client detail page, scroll down to Client portal access.

Portal section

You'll see an empty panel with an Invite Client button, or existing portal contacts if any are already added.

3

Open the invite modal

Open in app ↗

Click Invite Client to open the Grant portal access dialog.

Invite modal

You'll see two access methods: Email a magic link (default) and Set a password.

4

Option A: Send a magic link

Open in app ↗

On the Email a magic link tab, enter the contact's name, email, and an optional message, then click Send Invitation.

Magic link invite

You'll see "Invitation sent". The client gets an email with a one-click sign-in link. No password to manage.

5

Option B: Set a password

Open in app ↗

Switch to Set a password, enter name and email, click the refresh icon to generate a strong password, then click Create Access.

Password mode

You'll see the generated password ready to copy. No email is sent; share it directly with your client.

Use password mode when you want to hand credentials in a call rather than waiting for an email to arrive.
6

Confirm access is granted

Open in app ↗

Close the modal and check the Client portal access panel.

Portal user list

You'll see the contact row with an Invited badge (waiting for first login) or Active once they sign in, plus their last login time.

7

Revoke access

Open in app ↗

Click the ... menu next to the contact and choose Delete access.

Revoke access

You'll see the contact removed instantly. They can no longer sign in to the portal.

Done. The client can access their read-only dashboard, and you can remove that access at any time.

5What your client sees in the portal

Goal: understand exactly what a portal contact can see and do after you give them access. ReferenceRead-only
This is the view from your client's side after they accept the invite. Everything here is read-only and scoped to their client only.
Sign in Overview Full report Settings
1

Overview page

After signing in, the client lands on Overview: headline KPIs (Total Spend, Conversions, ROAS, Sessions), a daily spend trend chart, and a date range picker. Click View full report to go deeper.

Portal overview

They'll see only their own client's data. No other clients appear anywhere in the portal.

2

Full report breakdown

On Reports, the client can filter by platform (Google Ads, Meta Ads, GA4, Search Console) and adjust the date range. Trend charts and a campaign table update to match.

Portal reports

They'll see spend trends, conversions, ROAS, GA4 sessions, Search Console performance, and per-campaign breakdowns depending on which platforms are connected.

3

Customize which KPIs are shown

The client can click Manage KPIs to choose which metrics appear in the headline grid. Their selection is saved in their browser.

Manage KPIs

They'll see a checklist of all available metrics: Spend, Conversions, ROAS, Impressions, Clicks, CTR, Revenue, Sessions, Users, Engagement Rate, Bounce Rate, and Search Console metrics.

4

Portal settings

Under Settings, the client can set their own display name, logo URL, and brand colors. This overrides the agency's default branding for their portal only.

Portal settings

They'll see branding controls with a color picker and logo URL field. Changes apply immediately to their portal.

Client portal summary: clients can view KPIs, trend charts, campaigns, and Search Console data for their own account. They can filter by platform, adjust date ranges, pick which KPIs show, and customize their portal branding. They cannot see other clients, edit campaigns, manage targets, or access agency settings.
FeatureAvailable to portal clientNotes
KPI headline cardsYesSpend, Conversions, ROAS, Sessions + more via Manage KPIs
Daily trend chartsYesSpend, conversions, ROAS, sessions
Campaign tableYesRead-only, expandable by ad group
Platform filterYesGoogle Ads, Meta, GA4, GSC, Basis, TikTok (if connected)
Date range pickerYesAny custom range
Search Console dataYesKeywords, search terms, geo breakdown
Raw data downloadYesFrom the Raw Data page
Portal branding (own)YesDisplay name, logo, colors
Other clients' dataNoStrictly scoped to their client
Campaign managementNoRead-only throughout
Targets and alertsNoAgency-side only
Platform connectionsNoAgency-side only
Team managementNoAgency-side only

RWho can do what

Admin

Everything, plus Settings: connect platforms, manage the team, control portal access.

Manager

All clients, reports, targets, and client invites. No Settings.

Member

Only assigned clients. View and report; no team or settings.

ActionAdminManagerMember
View Home & ReportingYesYesAssigned
Generate / schedule reportsYesYesNo
Create targets & alertsYesYesAssigned
Connect / reconnect platformsYesView onlyView only
Invite a client to the portalYesYesNo
Manage team & settingsYesNoNo
Clips are real screen recordings of the live app signed in as a test admin, on seeded demo data. Two screens are illustrations rather than recordings, because they cannot be captured from the running app: the provider account-picker (step 1.4, only exists mid sign-in redirect) and the generated PDF report (step 3.4).