Skip to content

Commit fecfbf8

Browse files
authored
Update errors-enabling-salesforce-server-to-server-flow.md
Edit review per CI 8745
1 parent b274b3f commit fecfbf8

1 file changed

Lines changed: 39 additions & 35 deletions

File tree

support/sales-copilot/crm-permissions-and-configurations/errors-enabling-salesforce-server-to-server-flow.md

Lines changed: 39 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
---
2-
title: Errors When Enabling Salesforce with Server-to-Server Flow
3-
description: Troubleshoot errors that might occur when enabling Salesforce with a server-to-server flow in Sales app.
2+
title: Errors When Enabling Salesforce in Server-to-Server Flow
3+
description: Troubleshoot errors that occur when you try to enable Salesforce in a server-to-server flow in the Sales app.
44
ms.date: 12/16/2025
55
ms.reviewer: marrabi, shjais, v-shaywood
66
ms.custom: sap:CRM Permissions and Configurations\CRM Settings
77
---
8-
# Errors that occur when enabling Salesforce with server-to-server flow
8+
# Errors occur when enabling Salesforce in a server-to-server flow
99

10-
This article helps you troubleshoot errors that might occur when you try to enable Salesforce in a server-to-server flow in Sales app.
10+
This article helps you troubleshoot errors that occur when you try to enable Salesforce in a server-to-server flow in the Sales app.
1111

1212
## Who is affected?
1313

@@ -24,39 +24,37 @@ This article helps you troubleshoot errors that might occur when you try to enab
2424

2525
### Symptoms
2626

27-
When you try to enable Salesforce in a server-to-server flow, the following error message might occur:
27+
When you try to enable Salesforce in a server-to-server flow, you receive the following error message:
2828

2929
> Couldn't assign permission set because the integration user is inactive in Salesforce.
3030
3131
### Cause
3232

33-
During the Salesforce server-to-server flow setup, a connected app is deployed to the Salesforce organization. The connected app is associated with an integration user that is created automatically. A permission set is then assigned to the integration user. The error occurs when the integration user is inactive in Salesforce. The permission set can't be assigned to an inactive user.
33+
During the Salesforce server-to-server flow setup, a connected app is deployed to the Salesforce organization. The connected app is associated with an integration user that's created automatically. A permission set is then assigned to the integration user. The error occurs if the integration user is inactive in Salesforce. The error occurs because a permission set can't be assigned to an inactive user.
3434

3535
### Resolution
3636

3737
To resolve this issue:
3838

3939
1. In Salesforce, search for the **Sales Integration User** user.
40-
41-
1. Confirm the user is active.
42-
- If inactive, set the user status to active.
43-
- If you can't activate the user, contact [Microsoft support](/microsoft-sales-copilot/get-support).
40+
1. Check whether the user is active.
41+
1. If the user is inactive, set the user status to active. If you can't activate the user, contact [Microsoft Support](/microsoft-sales-copilot/get-support).
4442

4543
## Couldn't create user because Salesforce integration license limit reached
4644

4745
### Symptoms
4846

49-
When you try to enable Salesforce in a server-to-server flow, the following error message might occur:
47+
When you try to enable Salesforce in a server-to-server flow, you receive the following error message:
5048

5149
> Couldn't create user because Salesforce integration license limit reached.
5250
5351
### Cause
5452

55-
During the Salesforce server-to-server flow setup, a connected app is deployed to the Salesforce organization. The connected app is associated with an integration user that is created automatically. A Salesforce Integration user license is assigned to this integration user. The error occurs when the maximum number of Salesforce Integration user licenses is reached.
53+
During the Salesforce server-to-server flow setup, a connected app is deployed to the Salesforce organization. The connected app is associated with an integration user that's created automatically. A Salesforce Integration user license is assigned to this integration user. The error occurs if the maximum number of Salesforce Integration user licenses is reached.
5654

5755
### Resolution
5856

59-
To resolve this issue, check if you reached the maximum number of Salesforce Integration user licenses. If you reached the maximum, reassign existing integration users to other licenses or purchase more licenses.
57+
To resolve this issue, check whether you reached the maximum number of Salesforce Integration user licenses. If you reached the maximum, reassign existing integration users to other licenses, or purchase more licenses.
6058

6159
To check the number of integration user licenses available in your Salesforce organization:
6260

@@ -66,79 +64,85 @@ To check the number of integration user licenses available in your Salesforce or
6664

6765
1. Under **User Licenses**, check the number of available **Salesforce Integration** licenses in the **Remaining Licenses** column. If the number is **0**, deactivate existing integration users or change their licenses to other types. You can also purchase more licenses.
6866

69-
## Unexpected errors when enabling Salesforce with a server-to-server flow
67+
## Errors when enabling Salesforce in a server-to-server flow
7068

7169
### Symptoms
7270

73-
When you try to enable Salesforce in a server-to-server flow, you might receive one of the following error messages:
71+
When you try to enable Salesforce in a server-to-server flow, you receive one of the following error messages:
72+
73+
> Couldn't get deployment status due to incorrect ID format.
74+
75+
> Couldn't find the connected app.
76+
77+
> Couldn't get user license ID is missing to create connection user.
78+
79+
> Couldn't fully remove connection data from Dataverse. Contact Sales support to request manual cleanup.
80+
81+
> Couldn't complete the connected app or permission set deployment to Salesforce. Try again.
82+
83+
> Couldn't complete the connected app deployment to Salesforce. Try again.
7484
75-
- > Couldn't get deployment status due to incorrect ID format.
76-
- > Couldn't find the connected app.
77-
- > Couldn't get user license ID is missing to create connection user.
78-
- > Couldn't fully remove connection data from Dataverse. Contact Sales support to request manual cleanup.
79-
- > Couldn't complete the connected app or permission set deployment to Salesforce. Try again.
80-
- > Couldn't complete the connected app deployment to Salesforce. Try again.
81-
- > Couldn't complete the permission set deployment to Salesforce. Try again.
85+
> Couldn't complete the permission set deployment to Salesforce. Try again.
8286
8387
### Cause
8488

85-
During the Salesforce server-to-server flow setup, a connected app is deployed to the Salesforce organization. The connected app is associated with an integration user that is created automatically. A permission set is then assigned to the integration user. In this process, some unexpected errors might occur.
89+
During the Salesforce server-to-server flow setup, a connected app is deployed to the Salesforce organization. The connected app is associated with an integration user that's created automatically. A permission set is then assigned to the integration user. During this process, errors occur.
8690

8791
### Resolution
8892

89-
To resolve this issue, retry the operation. If the problem continues, gather the error details and contact [Microsoft support](/microsoft-sales-copilot/get-support).
93+
To resolve this issue, retry the operation. If the problem continues, gather the error details, and contact [Microsoft Support](/microsoft-sales-copilot/get-support).
9094

9195
## No changes were made
9296

9397
### Symptoms
9498

95-
When you try to enable Salesforce in a server-to-server flow, the following error message might occur:
99+
When you try to enable Salesforce in a server-to-server flow, you receive the following error message:
96100

97101
> No changes were made.
98102
99103
### Cause
100104

101-
During the Salesforce server-to-server flow setup, a connected app is deployed to the Salesforce organization. The connected app is associated with an integration user that is created automatically. A permission set is then assigned to the integration user. The error occurs when the same permission set is already assigned to the user.
105+
During the Salesforce server-to-server flow setup, a connected app is deployed to the Salesforce organization. The connected app is associated with an integration user that's created automatically. A permission set is then assigned to the integration user. The error occurs if the same permission set is already assigned to the user.
102106

103107
### Resolution
104108

105-
To resolve this problem, check for any manual changes to the connected app or profiles with the `CopilotForSales` prefix. If you find unintentional changes, revert them. Otherwise, retry the operation. If the problem continues, contact [Microsoft support](/microsoft-sales-copilot/get-support).
109+
To resolve this problem, check for any manual changes to the connected app or profiles that have the `CopilotForSales` prefix. If you find unintentional changes, revert them. Otherwise, retry the operation. If the problem continues, contact [Microsoft Support](/microsoft-sales-copilot/get-support).
106110

107111
## The profile name is already in use. Pick a different name or rename the existing profile in Salesforce
108112

109113
### Symptoms
110114

111-
When you try to enable Salesforce in a server-to-server flow, the following error message might occur:
115+
When you try to enable Salesforce in a server-to-server flow, you receive the following error message:
112116

113117
> The profile name is already in use. Pick a different name or rename the existing profile in Salesforce.
114118
115119
### Cause
116120

117-
During the Salesforce server-to-server flow setup, the process creates a profile named **Sales Integration Profile** in the Salesforce organization. The error occurs when a profile with the same name already exists, which prevents the creation process.
121+
During the Salesforce server-to-server flow setup, the process creates a profile that's named **Sales Integration Profile** in the Salesforce organization. The error occurs if a profile that has the same name already exists. This situation prevents you from creating a new profile.
118122

119123
### Resolution
120124

121-
To resolve this issue, check if a profile with the same name already exists in the Salesforce organization. If you created the profile before enabling the server-to-server flow, rename the existing profile and try again. If you didn't create the profile, contact [Microsoft support](/microsoft-sales-copilot/get-support).
125+
To resolve this issue, check whether a profile that has the same name already exists in the Salesforce organization. If you created the profile before you enabled the server-to-server flow, rename the existing profile, and then try again. If you didn't create the profile, contact [Microsoft Support](/microsoft-sales-copilot/get-support).
122126

123127
## Required fields are missing
124128

125129
### Symptoms
126130

127-
When you try to enable Salesforce in a server-to-server flow, the following error message might occur:
131+
When you try to enable Salesforce in a server-to-server flow, you receive the following error message:
128132

129133
> Required fields are missing: \<FieldName\>
130134
131135
### Cause
132136

133-
During the Salesforce server-to-server flow setup, a connected app is deployed to the Salesforce organization. The connected app is associated with an integration user that is created automatically. This error occurs when custom validation rules for user creation prevent the integration user from being automatically created in Salesforce.
137+
During the Salesforce server-to-server flow setup, a connected app is deployed to the Salesforce organization. The connected app is associated with an integration user that's created automatically. This error occurs if custom validation rules for user creation prevent the integration user from being automatically created in Salesforce.
134138

135139
### Resolution
136140

137141
To resolve this issue:
138142

139-
1. Temporarily disable the custom validation rules for user creation by going to **Setup** > **Object Manager** > **User** > **Validation Rules**.
140-
1. Retry setting up the Salesforce connection in the [Sales admin settings](/dynamics365/sales/admin-settings-overview).
141-
1. After the Salesforce connection is set up and the integration user created, re-enable your validation rules.
143+
1. Temporarily disable the custom validation rules for user creation. To make this change, go to **Setup** > **Object Manager** > **User** > **Validation Rules**.
144+
1. Try again to set up the Salesforce connection in the [Sales admin settings](/dynamics365/sales/admin-settings-overview).
145+
1. After the Salesforce connection is set up and the integration user is created, re-enable your validation rules.
142146

143147
## More information
144148

0 commit comments

Comments
 (0)