Follow these instructions to connect and authorize TruSales with Microsoft Dynamics.

Note: The application user permissions required and the minimum required fields for the TruSales integration is shown at the bottom of this page.

TruSales Security Roles
Download and import the “TruSales Security Roles” solution to get the pre-configured security role for the TruSales Application User you will create. The security role includes all of the required permissions the application user will need to access the desired organization data.

First TruSales Login
Follow the TruSales invitation link sent to you by your Primary Intelligence implementation specialist and click on the “Microsoft Dynamics 365” login link to log into TruSales using your MS Dynamics admin account.

Permissions Request
Once logged in, you will be asked to grant TruSales the permissions it requires to connect with your MS Dynamics environment. Please review the requested permissions and select “Accept” to proceed.

Note: You can check the “Consent on behalf of your organization” option to grant these permissions for other users in your organization.

Select Dynamics Environment
Select the MS Dynamics environment you will be integrating with your TruSales instance.

Your TruSales Application ID
Once you reach the “Required Setup Application User” window in TruSales, follow the steps below to import the pre-configured security role, create an Application User in your MS Dynamics environment and apply the security role to the new application user. The application user is used for all data integrations between TruSales and MS Dynamics.

Note: The “TruSales Application ID” value from this window will be needed for the application user.

Download “TruSales Security Roles” Solution
Download the “TruSales Security Roles” compressed solution file located at the top of this page, or click this link: TruSales Security Roles.

Navigate to the “Solutions” directory. Select “Import” in the action bar.

Note: You can import the solution using either Dynamics or Power Apps. Choose the “Import Solution” section that best suits your organization. This choice will not affect the results of the installation.

Import “TruSales Security Roles” Solution
Select “Choose File” and select the “TruSales Security Role” compressed solution file.

Select “Import” on the Solution Information screen.

Your Application User for TruSales
Log into MS Dynamics using an account with sufficient permissions to create an Application User. Navigate to the “Security” page under “System Settings.”

Navigate to the “Users” directory.

Navigate to the Application User View
Use the view dropdown menu to select the “Application Users” view.

Note: If you have not selected the “Application Users” view, you will get an “Add and License Users” popup when you select “NEW” and will be unable to proceed.

Create Your Application User
Select “NEW” in the action bar to create a new application user for TruSales.

Navigate to the Application User Form
Make sure you are on the “Application User” form using the form dropdown menu.

Apply TruSales Application ID
In the “Application ID” field, enter the “TruSales Application ID” from the “Required Setup Application User” step in the TruSales login process and select “SAVE” in the action bar.

Note: You will encounter an “Azure application ID not found” error if you have not accepted the application permission request in the initial TruSales login process. Please use the invitation URL provided by your Primary Intelligence implementation specialist to follow the initial login process until you have reached the “Required Setup Application User” step.

Navigate to Manage Roles
Now that the Application User has been created, select “MANAGE ROLES” in the action bar to give it a security role.

Assign TruSales Security Role
Select the “TruSales Application User” security role from the role list and select “OK” to assign the security role to your TruSales application user.

Note: If you did not import the “TruSales Security Roles” solution you can manually add the necessary permissions TruSales needs. Follow the “Application User Permission Requirements” section below to create a custom security role for your application user.

Application User Permission Requirements

Your TruSales application user will need the following “read” permissions:

• Account
• Activity
• Connection
• Connection Role
• Contact
• Opportunity
• Opportunity Relationship
• Relationship Role
• Competitor
• Product
• Currency
• Organization
• Security Role
• User
• Entity
• Field
• Relationship

And the following create permissions:

• Connection
• Contact

And the following miscellaneous privileges:

• View Audit History
• View Audit Summary