What this guide covers
How to connect an Outlook mailbox (Microsoft 365 for work, or Outlook.com,
Hotmail and Live for personal accounts), how to put jobs and customers in
Outlook, and what stays in sync once they are connected.
What you get
- Your Outlook mail in the JobsiteOn inbox. Mail from your Outlook Inbox
and Sent Items shows up in JobsiteOn, grouped by conversation.
- Changes go both ways. Mark a message read or unread, archive it, delete
it or flag it in JobsiteOn and Outlook shows the same a few seconds later.
Delete moves the message to Deleted Items in Outlook, and archive moves it to
the Archive folder. Do it in Outlook and JobsiteOn usually catches up within
a minute. If Microsoft's notice gets lost, a regular check catches up within
about 20 minutes.
- Send as yourself. Inbox email, quotes, invoices and payment reminders can
go out from your own Outlook address and land in your Outlook Sent Items. See
Send from your Outlook address.
- Jobs and customers in Outlook. An owner or admin can also put scheduled
jobs on a "JobsiteOn Jobs" calendar and keep customers in a "JobsiteOn"
contact folder.
Before you begin
- Connecting a mailbox is included on every plan, Starter included.
- Use the Microsoft account that owns the mailbox you want in JobsiteOn.
- Work accounts (Microsoft 365): most companies need their Microsoft 365
admin to approve JobsiteOn once. If you are that admin, you can do it in one
step: under Outlook, click Get approval. See
Approve JobsiteOn as a Microsoft 365 admin.
- Personal accounts (Outlook.com): no admin step. You approve JobsiteOn
yourself.
Connect your mailbox
- Open Settings, then Marketplace, and choose Microsoft Outlook.
- Under Your Outlook mail, click Connect next to Outlook. You can also do this under Connected Mailbox in Settings, Email & Inbox.
- Pick your Microsoft account and sign in.
- Review what JobsiteOn asks for and click Accept.
- You land back in JobsiteOn. The first sync brings in the last 30 days of
your Inbox and Sent Items. It runs on its own, even if you close the page.
If you connect while you're in your sandbox, the mailbox is connected to your
live account.
To see these steps in JobsiteOn, click How do I connect Outlook and what
stays in sync? under Connected Mailbox. It plays a 20-second clip of the
connect, with the steps written out under it.
Screenshot: The Connected Mailbox section with Outlook connected, showing the address and the last sync time.
Send from your Outlook address
When you connect Outlook and your mailbox doesn't have a Send from address yet,
your Outlook address becomes it: replies and new email leave from it and show up
in its Sent Items. To check or change it:
- In Settings, Email & Inbox, go to Send Client Emails From.
- Choose Connected Outlook if it is not already selected.
Inbox email, quotes, invoices and reminders you send then go out from your
Outlook address. Some automatic emails still come from JobsiteOn; the
Send from your Outlook address article
lists them. You can switch back to your JobsiteOn address at any time.
An owner or admin connects these for the whole workspace. They sync your live
workspace, not the sandbox. Calendar and Contacts each have their own
Microsoft sign-in.
- Go to Settings, then Marketplace, and open Microsoft Outlook.
- Click Connect calendar. JobsiteOn first asks "Connect Outlook
Calendar?" and says how many scheduled jobs it will add. Click Confirm,
then sign in with the Microsoft account to use. The first sync starts right
away.
- For contacts, click Connect contacts (once the calendar is connected,
it is Connect next to Contacts under Sync settings). JobsiteOn
asks "Connect Outlook Contacts?" and says how many customers it will add.
Click Confirm and sign in again.
You can connect contacts without the calendar, or the calendar without
contacts.
What happens next:
- Scheduled jobs appear on the JobsiteOn Jobs calendar in Outlook. Drag an
event to a new time in Outlook and the job's next visit moves on the
Schedule, and the assigned crew is told, as when you move it in JobsiteOn.
A visit that is still ahead cannot be moved to a time that has already
passed: nothing changes in JobsiteOn, and the event goes back to the
visit's time, usually at the next sync (an event dragged more than 30 days
back returns the next time the job changes). To record that a visit
happened earlier, move it on the Schedule in JobsiteOn.
When the job has no upcoming visit but one that is overdue (its time has
passed and it is not finished or cancelled), dragging the event to a time
that is still ahead moves that visit. Otherwise only the job's planned
dates move, and nobody is told. Finished jobs keep their times.
- Other changes to a job's event in Outlook, such as its title, stay until the
job changes in JobsiteOn; then the job's details replace them. If you delete
a job's event in Outlook, the job stays, and the event comes back the next
time the job changes. Events you add to the calendar yourself stay in Outlook
only.
- Customers appear in the JobsiteOn contact folder. Changes you make there
to a name, email, phone number, job title, notes or address come back into
JobsiteOn. The company is never changed from Outlook, clearing a field in
Outlook leaves the JobsiteOn value as it is, and contacts you add to the
folder yourself are not brought in as new customers.
- JobsiteOn keeps one email and one work phone for a customer: the contact's
first email and first business phone in Outlook. A second email or business
phone you add to the contact in Outlook stays in Outlook, also when the
customer changes in JobsiteOn later. If you remove the customer's email or
work phone in JobsiteOn, the contact's emails or business phones are
cleared in Outlook as well.
- Deleting a contact in Outlook never deletes the customer in JobsiteOn. It
only stops syncing that contact until you change one of the details
JobsiteOn syncs for that customer, such as the name, email, a phone number,
the address or the notes.
JobsiteOn marks the calendar, the contact folder and every event and contact
it creates in Outlook. It never takes over a calendar or folder of the same
name that it did not create.
The Microsoft Outlook page shows how many records are in sync (the jobs on the
calendar and the customers in the contact folder, each on its own row), when
the last sync ran and when the next one runs. A change you make in Outlook
usually comes back within a minute. If Microsoft's notice gets lost, a regular
check catches up within about 15 minutes. A change you make in JobsiteOn
usually reaches Outlook within a minute. An open Schedule updates by itself.
When a job or contact changes in both places before they sync, the most recent
edit wins. Click Sync now to sync at once.
What JobsiteOn can see
JobsiteOn reads your Inbox and Sent Items, the JobsiteOn Jobs calendar and
the JobsiteOn contact folder. It does not read your other folders, other
calendars' event details or your other contacts. Tokens are encrypted, and
your Microsoft password never reaches JobsiteOn.
Disconnect
- Your mailbox: in Settings, Email & Inbox, Connected Mailbox,
click Disconnect next to Outlook. You choose whether the mail already
synced stays in JobsiteOn as customer history or is deleted from JobsiteOn.
It stays in Outlook either way.
- Calendar and contacts: open Microsoft Outlook under Settings,
Marketplace and click Disconnect next to Sync now. Jobs and
customers already synced stay in both places, unless you tick the option to
remove what JobsiteOn made in Outlook.
Remove Outlook Data from JobsiteOn
explains what each option removes, what stays, and how to remove JobsiteOn
from your Microsoft account.
Troubleshooting
Check how a mailbox is syncing
Go to Settings, Email & Inbox and find Mailbox Sync. Each connected mailbox shows
Healthy, Sync problem with the reason, or Waiting for first sync, with the time of
the last sync and the next check. Click Details for counts per folder and recent syncs,
or Sync now to sync at once. Right after you connect, the first import runs on its own,
even if you close the page.
Once a day JobsiteOn also compares its counts with Microsoft's, shown as "Microsoft: N,
JobsiteOn: M". Mail you send with Send a Bcc to myself, or to your own address, also lands
in your Outlook Inbox as a copy. JobsiteOn keeps that message once, as the email you sent, and
still counts the copy, so the two counts match.
Sending details to support
Contacting support about a mailbox that isn't syncing? Open Settings, Email & Inbox,
Mailbox Sync, click Details, and send us the Reference line at the bottom. It tells
us which connection to check and contains no password or mail.
"A removal of synced mail is pending"
You disconnected with Also remove the email synced from Outlook into JobsiteOn turned on,
and that removal hasn't finished. Choose Cancel the removal to keep that mail and connect,
or Let it finish. See Remove Outlook Data from JobsiteOn.
Microsoft says "Need admin approval"
Your company requires its Microsoft 365 admin to approve JobsiteOn. Back in JobsiteOn you see
"Your company's Microsoft 365 admin needs to approve JobsiteOn once before you can connect."
Follow Approve JobsiteOn as a Microsoft 365 admin,
then connect again.
The mailbox shows "Reconnect needed"
Microsoft ended the sign-in, usually after a password change or because your
company requires you to sign in again. Click Reconnect and sign in with the
same Microsoft account; JobsiteOn tells Microsoft which address you connected, so
the right account is suggested. Your mail history stays, and so does Send from.
"No Exchange Online mailbox" under Sync problem
The account you signed in with has no Outlook mailbox (for example, a
Microsoft 365 account without an email license). Disconnect it and connect
again with the account that owns the mailbox.
Related articles