# Setup the SalesTim Connector for Power Platform
This article explains how to register the SalesTim Connector as a custom connector for Microsoft Power Platform (opens new window).
⏱ Expected Duration
Creating the custom connector only requires a few operations that are described hereafter as a detailed step-by-step procedure. Assuming you have all the required access and permissions to execute it properly, it should take less than 10 minutes.
TABLE OF CONTENTS:
# Procedure Overview
Here is an overview of the overall procedure:
# 1. Create a new app registration in Azure Active Directory
To securely access your Microsoft 365 environment through the Microsoft Graph APIs, the first step is to create a dedicated app registration. An Azure AD app registration identifies a third-party app such as SalesTim, and defines the permissions you wan to grant to it. To learn more, you can refer to How and why applications are added to Azure AD (opens new window).
To create a new app registration, follow these steps:
- Open your Azure Active Directory portal (opens new window)
App registrationsfrom the left menu
New registrationfrom the top bar
- Give the app a name, such as:
SalesTim Power Platform Connector
- Select the option
Accounts in this organizational directory only, as you want to restrict access to your own tenant.
- Use this web redirection URL:
- From the
Overviewmenu, copy the
Application (client) ID, and keep it as we're gonna reuse it later. You can temporarily paste it here:
Application (client) ID:
- Open the
- Ensure that the
Access tokens (used for implicit flows)and
ID tokens (used for implicit and hybrid flows)options are checked from the
Implicit grant and hybrid flowssection, and save your updates if required.
- Open the
Certificates and secretsmenu and click
New client secret. A client secret is a kind of a password for your app, so manage it carefully.
- Give a name to your client secret such as:
SalesTim Power Platform Connector client secret
- Select the expiration option, and click
- Copy the
Secret Valuevalue (be careful, it will only be shown once), and keep it as we're gonna reuse it later. You can temporarily paste it here:
You should use the
Secret Value, not the
- Open the
API permissionsfrom the left menu and click
Add a permissionfrom the top bar
Microsoft Graph, then
- From the permissions list, select:
- OpenId permissions >
- Directory >
- Group >
- InformationProtectionPolicy >
- Mail >
- User >
- OpenId permissions >
- Then click
Grant admin consent for...then
You're done, you've created your app registration for the SalesTim Connector. You should also have saved for later the
Application (client) ID and
Client secret that we're gonna use in the next steps.
# 2. Import the SalesTim OpenAPI definition
Now that we've created the app registration, we're gonna use it to create our custom connector.
- To import the SalesTim API OpenAPI definitions for Power Automate and Power Apps, go to PowerApps (opens new window) or Power Automate (opens new window).
The custom connector you're about to create will be available for both PowerApps and Power Automate, as they're sharing the same list of connectors.
- In the navigation pane, select
New custom connectorthen choose
Import an OpenAPI from URL
- Give your connector a name, such as :
- Paste this URL:
- Upload the connector logo that you can download from:
- Set the icon background color to:
- Ensure that the authentication type is set to
OAuth 2.0and the identity provider is set to
Azure Active Directory
- Paste the previously copied
- Ensure that the login url is set to:
- Ensure that the tenant ID is set to:
- Set the resource URL to:
- Set the scope to:
Create connector, then
# 3. Update the Power Platform Connector
To update your Power Platform connector:
- Open the updated connector definition
- Copy the whole content
- From Power Apps or Power Automate, open your custom connector from the
Data \ Custom connectorsmenu
- Click on
- From the left page, replace the content by pasting the updated connector definition
# 4. Next Steps
Now that you've created the SalesTim connector, you can use it from Power Apps (opens new window), Power Automate (opens new window), and Power BI (opens new window). See the available Triggers and Actions for reference.
💡 To Go Further
Here are a few interesting articles that may give you some guidelines and new ideas on how to use the the SalesTim Connector: