Setup guide · HubSpot integration

From install to your first report in about five minutes.

Portal Checker connects to your HubSpot portal in read-only mode, audits it Hub by Hub and gives you a scored report with the changes that would move your numbers most — on the web and inside HubSpot.

Start my auditSee a sample report ›
5 min
from install to your report
Read-only
nothing in your portal changes
Any plan
free accounts included
EN · ES
site and report

01 / 10

What Portal Checker does

AI and automation are only as good as the context in your CRM. Portal Checker reads how your portal is set up and used, scores it Hub by Hub, and ranks the fixes by the goals you choose.

Read-only

We only request read permissions. We don't change or create anything in your account.

Backed by evidence

Every finding shows the exact number behind it and a link to check it in HubSpot.

Focused on outcomes

You pick up to four goals; the report orders its priorities around them.

Your HubSpot portal
Counts and settings: Smart CRM, Marketing, Sales, Service, Data, Revenue.
Read-only
Portal Checker
Deterministic audit engine. No AI writes your score.
 
Your report
On portalchecker.com and inside HubSpot, permanent and shareable.
The access key is deleted as soon as the audit finishes

02 / 10

Before you start

You need three things. Most teams already have all of them.

1
A HubSpot account

Any plan works, including free. Features your plan doesn't include are marked as not applicable and never lower your score.

2
Permission to install apps

Usually a Super Admin, or a user with App Marketplace access in HubSpot's user permissions.

3
A work email

Reports belong to your company domain, so personal email addresses (Gmail, Outlook…) are not accepted.

03 / 10

Install and connect

There are two ways in. Both end in the same place, and HubSpot only asks you to authorize once.

From the HubSpot Marketplace

Click Install app on the listing and authorize. You land on portalchecker.com to verify your email, choose your goals and run the audit.

From portalchecker.com

Click Start, verify your email and choose your goals. When you connect, HubSpot asks you to authorize the app.

  1. 01

    Verify your work email

    Enter your work email and we send you a 6-digit code. It expires in 10 minutes.

    • Access is per company domain: anyone on your team with an email at your domain can open your reports.
    • If someone at your company already started, they approve each new teammate.
    Illustration
    portalchecker.com/start
    Your audit starts with your work email.
    Work email
    ana@yourcompany.com
    6-digit code
    482916
    Verify and continue
    The code expires in 10 minutes.
  2. 02

    Unlock your audit

    The full report is a one-time payment through Stripe: $99 USD for 5 reports, with no subscription and no expiry. If you have a coupon, redeem it here instead.

    A report is only charged when it finishes. A failed audit doesn't use a credit.

    Illustration
    portalchecker.com/start
    Unlock your audit
    Portal Checker · 5 reports
    One-time payment · credits don't expire
    $99.00 USD
    Card number
    4242 4242 4242 4242
    MM / YY
    08 / 29
    CVC
    •••
    Pay $99 and continue
    I have a couponSecure checkout
  3. 03

    Pick your goals

    Choose up to 4 outcomes. We use them to order your priorities and give more weight to what matters to you.

    Illustration
    portalchecker.com/start
    What do you want to achieve?
    Pick up to 4. We'll order your report around them.
    Generate more leads
    Close more deals
    Improve visibility in search and AI
    Retain and grow customers
    Have data you can trust
    Automate manual work
    Align marketing and sales
    Make the most of AI (Breeze)
    Continue
  4. 04

    Connect HubSpot

    Click Connect with HubSpot, choose the portal and review the permissions. Everything we ask for is read-only.

    • If your plan doesn't include a product, HubSpot simply doesn't grant that permission. The install still works.
    • We read counts and settings — not the content of your emails, notes or conversations.
    Illustration
    app.hubspot.com/oauth/authorize
    CRM
    Portal Checker wants to connect to your HubSpot account
    Choose an account
    Your Company · 21458803
    It will be able to read
    Contacts, companies and deals (counts)
    Properties, pipelines and lists
    Workflows, forms and campaigns
    + more read-only permissions
    Read-only: nothing in your portal will change
    CancelConnect app
  5. 05

    Let the audit run

    It takes a few minutes. We go Hub by Hub and show you each step. You can close the tab: it finishes on its own and the link keeps working.

    When it finishes, we delete the access key. The report stays; the access doesn't.

    Illustration
    portalchecker.com/start
    68
    Auditing your portal
    Checking permissions and capabilities
    Smart CRM and data quality
    Marketing Hub
    Sales and Service Hub
    Calculating score and findings
    The access key is deleted when we finish
  6. 06

    Read your report

    You get an overall score, a score per Hub and the five actions that would move it most, ranked by your goals.

    • Every finding comes with the exact number, what to do and a link to check it in HubSpot.
    • Fixes are tagged as self-serve, assisted or needs a decision, so you know where to start this week.
    • The link is permanent: share it with your team.
    Illustration
    portalchecker.com/r/…
    Your portal has room to grow. Here's the map.
    44
    Overall score
    Smart CRM54
    Marketing61
    Sales71
    Service38
    Revenue40
    Agent29
    01Critical
    Every send to an address that already bounced hurts the delivery of all your emails.
    What to do: Suppress hard bounces and find the form that lets them in.
    3.1%
    of contacts hard-bounced

04 / 10

Your report inside HubSpot

Once installed, Portal Checker adds an app page to your portal, so your team can see the latest report without leaving HubSpot.

  • It shows your finished audits: summary, score by Hub and history against the previous one.
  • If a report hasn't been unlocked yet, the page tells you and links to unlock it.
  • It follows each user's HubSpot language. You decide who sees it with HubSpot's user permissions for the app.
Illustration
Apps · Portal Checker
Portal Checker
Anyone in this portal with access to the Portal Checker app can see this report.
44
Overall
Smart CRM54
Marketing61
Sales71
Service38
01Suppress hard bounces from every send
02Add a close date to open deals
03Give every ticket an owner
Open full report

05 / 10

Data we read, and why

Every permission is read-only and used by a specific check. Optional permissions are only granted if your plan includes that product; if one is missing, the related checks show as not verified and never lower your score.

Object in HubSpotPermissionWhat we use it for
ContactsRequiredcrm.objects.contacts.readTotals, field completeness, lifecycle stages, bounces and unsubscribes.
Companiescrm.objects.companies.readTotals and a sample of domains to spot duplicates.
Dealscrm.objects.deals.readStalled deals, missing close dates and lost reasons.
Ownerscrm.objects.owners.readWho owns records, including deactivated users.
Contact Propertiescrm.schemas.contacts.readWhich properties exist and how they are used.
Company Propertiescrm.schemas.companies.readWhich properties exist and how they are used.
Deal Propertiescrm.schemas.deals.readProperties, pipelines and stages.
Contact Listscrm.lists.readHow many lists exist and whether they are active.
FormsformsWhich forms exist and whether they are in use.
WorkflowsautomationActive workflows and their actions.
Leadscrm.objects.leads.readWhether prospecting with Leads is in use.
Campaignsmarketing.campaigns.readWhether campaigns are in use.
Ticketscrm.objects.tickets.readTicket totals and tickets without an owner.
Knowledge Basecms.knowledge_base.articles.readWhether the knowledge base has articles.
Quotescrm.objects.quotes.readWhether quotes are in use.
Line Itemscrm.objects.line_items.readWhether deals carry line items.
Productscrm.objects.products.readWhether there is a product catalog.
Invoicescrm.objects.invoices.readWhether invoices are in use.
Subscriptionscrm.objects.subscriptions.readWhether subscriptions are in use.
Userssettings.users.readHow many users have access.
Teamssettings.users.teams.readWhether teams are set up.
Custom Objectscrm.schemas.custom.readWhich custom objects exist (definitions only, no records).
We don't read the content of your emails, notes, calls or conversations, and we don't copy your contacts, companies, deals or tickets. We read counts and settings.

06 / 10

Pricing

$99
5 full reports

One-time payment in USD through Stripe. No subscription, credits don't expire.

0
Failed audits

A credit is only used when a report finishes.

Coupon
Got a code?

Redeem it when you start and skip the payment.

07 / 10

Privacy and security

The key is temporary

The access key is stored encrypted only while the audit runs and is deleted when it finishes — even if it fails.

We keep the report, not your data

We store counts, rates and account details (portal ID, domain, time zone, currency), never your records.

You can ask us to delete it

Write to soporte@mediasource.com.mx and we answer within 20 business days. Deleting a report doesn't uninstall the app.

Read the privacy policy ›

08 / 10

Disconnect or uninstall

The audit already deletes its access key, so nothing reads your portal after it finishes. To remove the app completely:

  1. 1In HubSpot, go to Settings → Integrations → Connected apps.
  2. 2Find Portal Checker and open Actions.
  3. 3Click Uninstall and confirm.
Open Connected apps in HubSpot ↗

Uninstalling removes the app page from your portal. Your reports stay available at their link until you ask us to delete them.

Illustration
Settings · Integrations
Connected apps
AppInstalled byActions
Portal CheckerActions ▾
View app details
View permissions
Uninstall

09 / 10

Troubleshooting

HubSpot says I can't install apps.

Installing needs App Marketplace access. Ask a Super Admin to install it or to grant you that permission.

Some areas say “not verified”.

Your plan doesn't include that product, so HubSpot didn't grant its permission. It doesn't affect your score.

My email was rejected.

Use your work email. Reports belong to your company domain, so personal email addresses aren't accepted.

The code didn't arrive.

It can take a minute. Check spam, and request a new one after 10 minutes.

I don't see the app page in HubSpot.

It appears after your first audit finishes. Make sure you're in the portal you connected.

I closed the tab while it was running.

No problem. The audit finishes on its own; open your report link or start again with the same email.

Need a hand?

Write to us and a person from our team will reply.