Getting Started with Office 365 in 2 minutes

We'll connect Office 365 and set SigParser to automatically create and update contacts every day for you.

  1. Go to Settings -> Data Sources and click "Add" on the Office 365 connector.
  2. Authenticate and accept the permissions.
  3. You should see a screen to configure your mailbox settings. Click the checkboxes for "Create contacts" and "Update contacts". Office 365 Setup Screen
  4. Click "Save"
  5. Go to the Dashboard to see the email processing progress. You will get an email when processing completes.

Need to monitor multiple mailboxes? See the Mailboxes section below.

If no contacts were created in Office 365, follow these troubleshooting steps.

Office 365 Security Permission Details

When you connect Office 365 we ask for the following permissions and for these reasons.

  • Mail.Read.Shared - Grants SigParser read only access to your email. This doesn't give SigParser any rights to modify or delete your email.
  • Calendars.Read.Shared - Allows SigParser to read the events on your calendar to display analytics in the user interface and discover more contact details.
  • Contacts.ReadWrite.Shared - Allows SigParser to create and update contacts automatically for you. By default SigParser doesn't but as soon as you're done connecting, you can enable this feature.
  • User.ReadBasic.All - Allows SigParser to discover your email address and also display suggestions when you're adding more mailboxes if you need to.
  • offline_access - Needed for SigParser to check your email and calendar every day without your intervention.


SigParser can manage multiple Office 365 mailboxes under a single connection such as mailboxes that are shared (support@...) or email accounts with delegated access to other mailboxes such as mailboxes of former employees or subordinates.

Adding Mailboxes

Click the "Add Mailbox" button in the Mailboxes section at the bottom of the connection page.

The value that goes in the textbox needs to be the "userPrincipleName" which is most often but not always the email address of the mailbox.

After typing the first few characters, if you wait a second SigParer will show some suggestions. Selecting one of the suggestions will fill in the "userPrincipleName" into the textbox for you.

Managing Settings

Each mailbox has it's own set of settings to control things like updating and creating contacts and permissions. You can also buy additional email history at a per mailbox level.

Disable Checking Mailboxes

You can disable checking a specific mailbox by clicking the "Disable Mailbox" button. This will not disable the entire connection of mailboxes.

Updating Contacts

Contacts are updated based on their email address.

  • Title
    • Only filled in if it is empty or previously set by SigParser.
  • Mobile Phone
    • Only filled in if it is empty or previously set by SigParser.
  • Other phone numbers
    • Only filled in if blank.
  • Address
    • Only filled in if blank.

Creating Contacts

Contacts are created if no contact already exists in Office 365 Contacts with the same email address. Contacts are always created per connected mailbox.

Caution!!! We suggest only enabling this feature if SigParser is only connected to your own personal email accounts. If your entire company's email accounts are connected to SigParser you could end up with tens of thousands of contacts being pushed to your Office 365 contacts.

SigParser will set the following fields on any contacts:

  • Title
  • Mobile Phone
  • Business Phones
  • Home Phones
  • Address

Missing contacts

If SigParser didn't create contacts in Office 365 that you expected it to, you can do the following to force it to resync the contacts. This can happen if the pervious processing job completed before you set the "Create contacts" checkbox to checked.

  1. Go to the Settings -> Data Sources
  2. Click "Edit" on email account
  3. Verify the "Create contacts" checkbox is checked on the mailbox you expect. This is at the bottom of the page.
  4. Go to the top of the page and click "Push Contacts".
  5. In the modal window, select a date in the past (format 1/1/2018) and you'll see an estimate of the number of contacts SigParser will attempt to resync.
  6. Click "Submit". It will then run a job to try and push any contacts it can.