Try ShortPoint nowDo you have an Outlook Contact list? If you do, you're in the right place!
With the ShortPoint Microsoft Graph API, you can pull and display Outlook contacts right in your SharePoint sites, making SharePoint Online feel like a natural extension of the Microsoft 365 ecosystem. In this article, we'll show you exactly how to showcase your contact data in SharePoint.
NOTEThe contacts listed in the connection will vary depending on the signed-in user’s contact list.
TABLE OF CONTENTS
Prerequisites
- You must have ShortPoint SPFx version 8.6.0.0 and up installed.
- You also need to be a ShortPoint Designer with either a Pro or Enterprise license. For more details, check out Licensing Options.
- You must have the Microsoft Graph API connection enabled. Go to How to Enable Microsoft Graph Integration for MS Graph API Connections to learn how.
- You must authorize the necessary permissions (Contacts.Read) in the API access page. To check, go to your SharePoint Admin Center > Advanced > API access.
- You must have the Design Element you want to use to connect on your SharePoint page. For best results, we recommend using Design Elements that allow listing of multiple items (Icon List, Simple List, etc.).
- The signed-in user must have an Outlook contact list. Otherwise, the connection will appear empty.
What is the “My Contacts” Use Case?
The My Contacts use case allows you to "GET" information from a user's personal address book or even shared contact folders within an organization.
With this use case, you can showcase the signed-in user's Outlook contact list, providing easy access to multiple contacts:
The typical structure of this use case is:
https://graph.microsoft.com/v1.0/users/[%Me('email')%]/contactsYou must enable the following permissions in the SharePoint Admin Center to use it:
Contacts.Read gives permission to retrieve contacts of users in your organization.
NOTEIf you haven’t given access to the permissions above, go to your SharePoint Admin Center > Advanced > API access.
Step-by-step Tutorial
Follow the steps below to learn how to use the My Contacts use case with Microsoft Graph API integration to showcase your SharePoint contacts effectively.
Step 1: Edit the ShortPoint Web Part
Go to the SharePoint page you want to use and click Edit:
Select the ShortPoint web part and click the Edit Properties icon:
Step 2: Edit the Design Element
NOTEYou can use any Design Element you want. For best results, we recommend using Design Elements that allow listing of multiple items (Icon List, Simple List, etc.)
Click the EasyPass tag of the Design Element you’ll use:
Select the cogwheel icon:
Step 3: Open the Connect Window
Go to the Connect tab:
Click Configure to open the connect window:
Step 4: Connect to Microsoft Graph API
Select Microsoft Graph API:
NOTEYou need to enable the Microsoft Graph API connection before using it. Learn more about it in How to Enable Microsoft Graph Integration for MS Graph API Connections.
Step 5: Use the My Contacts Use Case
Search for My Contacts and select it:
Step 6: Connect
Click Run Query:
Select Connect:
Step 7: Map Items
Go to the Items tab:
Delete default content:
Use the link icon to map the properties you want to be displayed:
You can map any property you want. In our case, we used the following properties:
- #displayName - shows the name of the contact.
- #emailAddresses_0_address - shows the email address of the contact.
- #mobilePhone - shows the phone number of the contact.
NOTECheck out ShortPoint Connect: How Items Mapping Works to learn more about mapping properties.
Step 8: Save
Select Preview to see how the Design Element looks:
Click Update to apply your changes:
Click the green checkmark:
Once satisfied, click Save:
And Publish your page:
You're all set! You can now display Outlook contacts on your SharePoint page, making it super easy to access business contacts without navigating multiple tabs.
Frequently Asked Questions
How can I display my Outlook contacts on a SharePoint site?
You can display Outlook contacts on a SharePoint site by using the ShortPoint Microsoft Graph API integration. This allows you to pull your Outlook contact list into SharePoint pages using design elements like Icon List or Simple List, making your SharePoint contacts accessible and easy to manage.
What permissions are required to access SharePoint contacts using Microsoft Graph API?
To access SharePoint contacts via Microsoft Graph API, you must enable the Contacts.Read permission in the SharePoint Admin Center under API access. This permission allows the retrieval of contacts from users' Outlook address books within your organization.
What prerequisites are needed to use the ShortPoint Microsoft Graph API for contacts?
You need ShortPoint SPFx version 8.6.0.0 or higher, a Pro or Enterprise ShortPoint Designer license, and Microsoft Graph API connection enabled with proper permissions. Additionally, users must have an Outlook contact list to display data successfully.
Related articles:
- How to Enable Microsoft Graph Integration for MS Graph API Connections
- Microsoft Graph API: Supported and Non-Supported Endpoints
- Getting Started With Microsoft Graph API Use Cases
