← All posts

Best Practice: Onboarding a New Tenant

Most of the trouble in a new MSP Pulse tenant comes from setting things up in the wrong order. Nothing breaks outright. The pay calendar quietly lands a pay run on a bank holiday, an engineer gets invited before the labour roles exist so has nothing to log time against, or the SLA clock counts hours your team never works. Each one is easy to fix once you spot it, and easy to miss for weeks first.

This guide gives you a setup order where each step has what it needs from the one before. It starts with enrolling your first device on Secure Access, which a new company must do before anything else, then the AI-guided setup, which covers the next few steps for you, and moves through the settings that make the calendar, leave, timesheets and payroll behave.

1. Set up Secure Access and enrol your first device

Secure Access is not optional. It is how MSP Pulse protects your company's data: it can only be reached from devices you have enrolled, over a private network. The sign-in page stays public, but there is no public route to the data behind it.

That is why a new company's access is restricted from the start. When the owner first signs in, they are taken to Secure Access and asked to enrol a device before anything else. Until a device is enrolled and connected, the rest of MSP Pulse stays locked, so the guided setup and the settings in this guide wait until it is done. Do it first, and do it properly, because everything else in this guide is built on it.

The steps are:

  1. Install the PON Agent on your own computer. Go to app.msp-pulse.com/agent. It detects your operating system and offers the right installer (Windows, macOS or Linux). You can download it without signing in because it does nothing without an enrolment code. Phones and tablets use a QR code instead, shown on the same Secure Access page.
  2. Get an enrolment code. In Settings → Organisation → Secure Access, choose Enrol a device. You get a short single-use code. Run the PON Agent, type the code in, and restart the computer if the installer asks you to.
  3. Check the status chip. Back on the Secure Access page, the chip should read Connected to Secure Access. That chip is the real test. The agent's own tray icon only tells you it is running, not that your traffic is going over the private network.
  4. Carry on over Secure Access. Once your device is confirmed connected, Secure Access takes effect and the restrictions lift. From here on, sign in to MSP Pulse from the enrolled computer.

Why first. Do this before anything else, and before inviting anyone, so each person only has to do it once. Every invitation email carries the PON Agent download link and the enrolment steps. A team member cannot sign in until they have an enrolled device, so after inviting them you generate their first enrolment code yourself, under Enrol a team member's device on the same Secure Access page, and send it to them securely. They install the agent, enter the code, and they are in. If you invite people before you have enrolled yourself, you cannot do this for them, and the whole team waits on you. A second device for the same person waits as pending until an owner or admin approves it, which is intentional.

Three things to know before you start:

2. Run the AI-guided setup

Once your device is connected, MSP Pulse offers a guided setup: a chat with an assistant that asks you questions and prepares the settings for you. It currently covers five things, in this order:

  1. Locale. Country, currency, timezone and date and time format.
  2. Company. Your company details, which appear on invoices, quotes and emails.
  3. Labour roles. The roles you bill time under, such as Engineer or Consultant, their rates, and optionally location and time modifiers (onsite, remote, after hours).
  4. Outbound email. How customer-facing email (invoices, quotes, ticket updates) is sent.
  5. Inbound email. The mailbox that turns incoming mail into tickets.

The assistant works on an assist-with-confirm basis. It proposes a change, you see it on a confirmation card, and nothing is saved until you approve it. Treat each card as a draft to read, not a button to click through. This is especially true of rates: the assistant can suggest sensible roles and modifiers, but only you know what you charge.

You can pause and come back. If you skip the setup or leave halfway, it isn't lost. Go to Settings → Company and use the Guided setup card to continue or restart it. Nothing you have already saved is undone by restarting.

The guided setup is deliberately short. It gets billing and email working so you can start. Everything below is what you set up next, and it matters just as much, because the assistant doesn't ask about it.

3. Set your working week and business hours

Go to Settings → SLA. This is where you set:

Do this early because several later things depend on it. The SLA clock uses these hours for P2 to P4 tickets (P1 counts 24 hours a day). The Calendar starts its week on the day you choose here. And the pay calendar in Section 5 uses your working days to decide when a pay run can fall.

If you want MSP Pulse to choose between office-hours and after-hours labour rates from the clock, the Office-hours rates card on the same page does that, using these business hours. It needs your labour roles to have both an office-hours and an after-hours rate, so come back to it once you are happy with your roles. If you would rather engineers pick the rate themselves, leave it on manual.

4. Add your public holidays

Still thinking about days off: add your National Holidays. They sit in Settings → Finance → Payroll. Use Add National Holiday for each date and name it.

They are not set up for you, so each year you will need to add them. Do it now, because holidays feed three things:

That last one is why holidays come before pay periods. Generate the pay calendar first and add holidays afterwards, and the dates will already have been calculated without them.

5. Set up your payroll schedule and pay periods

Still in Settings → Finance → Payroll, create a payroll schedule. It describes how often you pay people:

Then open the schedule's Pay calendar and add a pay year. A pay year doesn't have to be a calendar year, so use whatever window your payroll runs on. Choose Preview periods before saving. This is the review step: you see every period with its pay run and cutoff date, and a marker beside any date that was moved to the previous working day because it landed on a weekend or holiday.

Two things worth knowing:

6. Invite your people

Now that labour roles, working hours, holidays, a pay schedule and Secure Access are in place, invite the team. Go to Settings → Users and use Invite. Each person gets an email, sets their own password and sets up TOTP before first sign-in. The email also explains how to get their computer enrolled, but they need an enrolment code from you (Section 1) before they can use it.

Choose an Access Role for each person, in Settings → Access Roles. The owner or admin has full access. Other people get exactly the sections their role grants, and the seeded Engineer role covers day-to-day work such as the service desk, projects, calendar, clients, quoting and invoicing. Create narrower roles before you invite anyone who should see less, because it is easier to start with the right role than to remove access later. Note that Settings is one section: anyone with it can change any setting.

Then open each person's Employment tab (owner and admin only). This is where the earlier steps pay off:

7. Check the calendar and leave

By now the Calendar already shows each person's working hours, your public holidays, and any approved leave. Check it before the team relies on it. Open a few people's weeks and confirm the shaded non-working hours match what you meant.

For leave, the standard types (Vacation, Sick, Study Leave and Unpaid Leave) are already there. People request leave from their own Leave tab and an owner or admin approves it. Approved leave appears on the calendar and is taken out of the hours reported to payroll.

If your engineers use Outlook or Google Calendar, Settings → Service Delivery → Calendar Sync can push scheduled work into their own calendars. It is optional and off by default, and each company registers its own app with Microsoft or Google, so leave it until the basics are working.

8. Decide on the optional extras

These are all off or empty by default for a new tenant. Turn on only what you will actually use.

Pre-flight checklist for a new tenant