Help center
Open dashboard

MainWP

Connect your MainWP dashboard to Atarim so the sites you maintain and the feedback you collect live in one place.

Atarim team Updated 7 Oct 2026 · 8 min read
Integrations
Atarim integration settings showing the MainWP connection
Before you start

Relevant for

  • Agencies and developers who maintain WordPress sites through a MainWP dashboard.

Required knowledge

  • Access to your MainWP dashboard, and enough familiarity with it to enable the REST API and generate keys.

Tools & resources needed

  • An Atarim account on a plan that includes native integrations.
  • A MainWP dashboard with the REST API enabled.
  • The Atarim extension installed in MainWP.

MainWP is a self-hosted dashboard for managing multiple WordPress sites. Connecting it brings the sites you maintain and the client feedback you collect into one workflow. It is the most involved integration to set up, because it is the only one where credentials travel in both directions.

What you getWhere it shows
One-click visual collaborationA collaborate link on each site in your MainWP dashboard.
Task counts and listsAn Atarim column on the MainWP websites screen, and in the Atarim extension.
Website vitalsUpdates, status and security pulled from MainWP into your Atarim dashboard.
Task data in MainWP reportsTask information, and time entries on accounts with Time tracking, for your client reporting.
This connection goes both ways
Unlike every other integration, MainWP needs credentials entered in both directions. You paste MainWP’s keys into Atarim, and you paste Atarim’s key into the MainWP extension. Setting up only one side leaves the connection incomplete, and it will not be obvious which half is missing.

Install the MainWP Atarim Extension

Everything else depends on this. The extension is what receives the Atarim Key and surfaces your tasks inside MainWP.

Instructions:

  1. Download the MainWP Atarim Extension.
  2. Install it on your MainWP dashboard, following MainWP’s own instructions for installing extensions. The Atarim extension appears in your MainWP dashboard, ready to receive the key.

Enable the REST API in MainWP

Before anything else, MainWP’s REST API has to be switched on and a key pair generated. That is what Atarim uses to talk to your dashboard.

Instructions:

  1. Open your MainWP dashboard.
  2. Enable the REST API and generate a key pair. MainWP gives you a consumer key and a consumer secret — the Atarim panel links to MainWP’s own guide if you need the exact steps.
  3. Copy both, along with the URL of your MainWP dashboard.
Enabling the REST API in the MainWP dashboard
Enable the REST API in MainWP
The generated consumer key and consumer secret in MainWP
Generate a key pair — a consumer key and a consumer secret
Copy the consumer secret when it is first shown
Most systems display a secret once and never again — if you lose it, you will be generating a new pair rather than looking it up.

Enter Your MainWP Details in Atarim

Credentials travel from MainWP into Atarim here; the Atarim Key goes back the other way in the next step.

Instructions:

  1. In Atarim, go to Settings.
  2. Under Connected Apps, select Integrations.
  3. Find MainWP and switch its toggle on. The configuration fields expand beneath it.
  4. Fill in the three fields, submitting each one to save it.
FieldWhat goes in it
MainWP Consumer keyThe consumer key generated by MainWP’s REST API.
MainWP Consumer SecretThe matching consumer secret.
MainWP Dashboard URLThe address of your MainWP dashboard.
Copying the consumer key and secret from MainWP
Copy both values, along with your dashboard URL
The MainWP row switched on, with the API Key field and the MainWP Consumer key, Consumer Secret and Dashboard URL fields
The three fields expand beneath the toggle — submit each one to save it
MainWP is a plan feature
Where your plan does not include native integrations the option is locked and names the minimum plan required, and only the workspace owner can change the subscription. If Integrations is not in your sidebar at all, your role does not have access to it. Learn More About User Roles And Permissions

Enter the Atarim Key in MainWP

This is the half people miss. Atarim generates its own key, shown in the same panel, and it has to go into the Atarim extension inside MainWP.

Instructions:

  1. Find the API Key field in the MainWP section of the Integrations panel. This is your Atarim Key.
  2. Copy it using the copy control.
  3. Open your MainWP dashboard and go to the Atarim extension.
  4. Paste the key in and save. Both halves of the connection are now in place.
MainWP section of Integration Settings with the API Key field and its copy control
Copy the Atarim Key from the Integrations panel
The extension has to be installed first
The Atarim Key goes into the Atarim extension in MainWP, so that extension needs to exist before this step. If you cannot find where to paste the key, install the extension rather than assuming Atarim’s key is wrong.
Do both halves in one sitting
A half-configured connection fails quietly, and coming back to it a week later means working out which side you finished — considerably harder than just completing it now.

Collaborate on a MainWP Website

  1. In your MainWP dashboard, select the collaborate link on the website you want. The website opens in Atarim, ready for tasks, comments and annotations on the live site.
  2. Work as you would on any Atarim project. The number of tasks created appears against that site in your MainWP dashboard.
The website open in Atarim for visual collaboration
The website opens in Atarim, ready for tasks and annotations
Note
Annotations and tasks are an overlay for collaboration. They do not alter the actual website content, so there is no risk to the live site in letting a client comment freely.

See Website Vitals in Atarim

Once both halves are connected, MainWP pushes health information about your sites into your Atarim dashboard.

VitalWhat it shows
Updates pendingHow many plugin, theme and WordPress updates are pending.
Site statusWhether the site is currently online or offline.
Security issuesHow many security issues the site currently has.

On the Projects screen, each connected project’s card carries the MainWP mark. Hover over it to see these readings, then select Open in MainWP to open that site in your MainWP dashboard.

Website vitals from MainWP shown in the Atarim dashboard
Updates, status and security appear against each site in Atarim
The MainWP icon on a website in Atarim, linking back to the MainWP dashboard
The MainWP icon takes you straight to that site in MainWP
If vitals do not appear, check your permalinks
MainWP’s permalink structure must be set to Post Name for Atarim to pull this data. This is the single most common reason vitals stay blank after an otherwise correct setup — and nothing in either dashboard points at it, so it is worth checking first rather than last.

Refreshing Site Status

MainWP reports whatever it last checked, so a bulk re-check is what makes the status codes trustworthy.

Instructions:

  1. In MainWP, go to Sites → Monitoring.
  2. Select all of your websites.
  3. Open Bulk Actions, choose Check now, and select Apply. The status codes update, and the new values appear on the Projects screen in Atarim.
Running Check now from Bulk Actions in MainWP monitoring
Run Check now from Bulk Actions to refresh status codes

See Atarim Tasks Inside MainWP

Tasks created on your MainWP websites appear in three places in MainWP.

Instructions:

  1. On the MainWP websites screen, scroll right to the Atarim column. Selecting the button there lists every task on that website.
  2. Open a task from that list. A new tab opens on your Atarim inbox with that task displayed, ready to work on.
  3. Or open the Atarim extension for a task list per site, and the Overview screen for every task across your whole network.
A task list for a website shown in MainWP
The button lists every task on that website
The Overview screen in the Atarim extension showing tasks across the network
The Overview screen shows every task across your whole network
Tip
The Atarim task button inside the extension behaves differently from the one on the websites screen — it takes you straight to the collaborative view rather than showing a task list. Useful once you know which site you are working on.

Setup at a Glance

StepWhere it happensWhat it produces
Enable the REST APIMainWPA consumer key and consumer secret.
Switch MainWP onAtarim → IntegrationsThe configuration fields.
Enter key, secret and dashboard URLAtarimAtarim can reach your MainWP dashboard.
Copy the Atarim KeyAtarimThe key for the other direction.
Paste it into the Atarim extensionMainWPMainWP can reach Atarim.

Benefits

BenefitIn practice
One workflow, not twoSite maintenance and client feedback stop being separate systems.
Scales with your portfolioUseful whether you manage ten sites or two hundred.
Works with self-hosted MainWPYour dashboard stays where it is; Atarim connects to it.
Less context switchingFewer trips between dashboards during a working day.

FAQs

Why does this integration need keys in both directions?

Because both systems need to reach each other. MainWP’s consumer key and secret let Atarim talk to your dashboard; the Atarim Key lets MainWP talk back.

Where do I get the consumer key and secret?

From MainWP, by enabling its REST API and generating a key pair. The Atarim panel links to MainWP’s own guide.

Where does the Atarim Key go?

Into the Atarim extension in your MainWP dashboard.

What if I lose the consumer secret?

Generate a new pair in MainWP and enter both values in Atarim again.

Does this sync tasks to a project tool?

No. This connects your MainWP dashboard. Task syncing is handled by integrations such as Jira, Asana or Trello.

Will tasks created in Atarim show up in MainWP?

Yes. Tasks created on your websites through Atarim appear in the MainWP dashboard, including their current status.

Do Atarim annotations change the live website?

No. Tasks and annotations are a collaboration overlay — they do not alter the site’s actual content.

Can I disable the integration temporarily?

Yes. Switch it off from the Integrations panel in Atarim without deleting your configuration.

Does my MainWP dashboard need to be publicly reachable?

Atarim connects to the dashboard URL you provide, so it needs to be reachable from outside your network.

Common issues

  • The connection does not work after entering the keys — check the other half. The Atarim Key needs pasting into the Atarim extension in MainWP.
  • You cannot find where to paste the Atarim Key — the Atarim extension is not installed in MainWP yet. Install it first.
  • MainWP rejects the credentials — re-copy the consumer key and secret, and check the dashboard URL is the full address of your MainWP install.
  • You have lost the consumer secret — generate a new key pair in MainWP and enter both values again in Atarim.
  • The MainWP option is locked — your plan does not include native integrations. The lock names the minimum plan required.
  • Integrations is not in your settings sidebar — your role does not have access. Ask an Administrator.
  • Website vitals do not appear in Atarim — set the MainWP permalink structure to Post Name. If that does not fix it, contact support.
  • Site status looks out of date — in MainWP, go to Sites → Monitoring, select all sites, and run Check now from Bulk Actions.
  • The connection stopped working — keys may have been regenerated on either side. Re-enter the current values in both places.

Conclusion

Enable the REST API, paste the key, secret and dashboard URL into Atarim, then copy the Atarim Key back into the MainWP extension.

Complete both halves in one go. A connection that is half configured fails without telling you which half is missing.

Tips & best practices

  • Enable MainWP’s REST API before starting in Atarim.
  • Copy the consumer secret the moment it is shown.
  • Install the Atarim extension in MainWP before you need somewhere to paste the key.
  • Complete both halves in one sitting.
  • Use the full dashboard address for the URL field.
  • Set MainWP permalinks to Post Name so vitals sync.
  • Review site vitals weekly to catch maintenance issues early.
  • Assign tasks and set deadlines in Atarim before pulling them into MainWP reports.
  • Re-enter both sides if you ever regenerate keys.

Related articles