Authentication User Credentials
Contents
Description
Use delegated access (User Credentials) whenever you want to let a signed-in user work with their own resources or resources they can access. Whether it's an admin setting up policies for their entire organization or a user deleting an email in their inbox, all scenarios involving user actions should use delegated access. [API reference]
Instructions
Follow these simple steps below to create Microsoft Entra ID application with delegated access:
WARNING:
If you are planning to automate processes, we recommend that you use a Application Credentials authentication method.
In case, you still need to use User Credentials, then make sure you use a system/generic account (e.g.
automation@my-company.com
).
When you use a personal account which is tied to a specific employee profile and that employee leaves the company,
the token may become invalid and any automated processes using that token will start to fail.
- Navigate to the Azure Portal and log in using your credentials.
- Access Microsoft Entra ID.
-
Register a new application by going to
App registrations
and clicking on New registration button:
INFO: Find more information on how to register an application in Graph API reference.
-
When configuration window opens, configure these fields:
-
Supported account type
- Use
Accounts in this organizational directory only
, if you need access to data in your organization only.
- Use
-
Supported account type
-
Redirect URI:
- Set the type to
Public client/native (mobile & desktop)
. - Use
https://zappysys.com/oauth
as the URL.
- Set the type to
-
After registering the app, copy the Application (client) ID for later:
-
Then copy OAuth authorization endpoint (v2) & OAuth token endpoint (v2) URLs to use later in the configuration:
-
Now go to SSIS package or ODBC data source and use the copied values in User Credentials authentication configuration:
- In the Authorization URL field paste the OAuth authorization endpoint (v2) URL value you copied in the previous step.
- In the Token URL field paste the OAuth token endpoint (v2) URL value you copied in the previous step.
- In the Client ID field paste the Application (client) ID value you copied in the previous step.
-
In the Scope field use the default value or select individual scopes, e.g.:
-
email
-
offline_access
-
openid
-
profile
-
Mail.Read
-
Mail.Read.Shared
-
Mail.ReadBasic
-
Mail.ReadBasic.Shared
-
Mail.ReadWrite
-
Mail.ReadWrite.Shared
-
Mail.Send
-
Mail.Send.Shared
-
User.Read
-
User.ReadBasic.All
-
- Press Generate Token button to generate Access and Refresh Tokens.
- Optional step. Choose Default User Id from the drop down menu (if someone shared a mailbox with you).
- Click Test Connection to confirm the connection is working.
- Done! Now you are ready to use the API Connector!

Parameters
Parameter | Label | Required | Default value | Options | Description | ||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
AuthUrl | Authorization URL | YES |
|
|
|||||||||||||||||||||||||||||||
TokenUrl | Token URL | YES |
|
|
|||||||||||||||||||||||||||||||
ClientId | Client ID | YES |
|
||||||||||||||||||||||||||||||||
Scope | Scope | YES |
offline_access~email~Mail.Read~Mail.Read.Shared~Mail.ReadBasic~Mail.ReadBasic.Shared~openid~profile~User.Read~User.ReadBasic.All~Mail.ReadWrite~Mail.ReadWrite.Shared~Mail.Send~Mail.Send.Shared~
|
|
|
||||||||||||||||||||||||||||||
ReturnUrl | Return URL | YES |
https://zappysys.com/oauth
|
|
|
||||||||||||||||||||||||||||||
ClientSecret | Client Secret |
|
|||||||||||||||||||||||||||||||||
RefreshTokenFilePath | Refresh Token File Path |
|
|||||||||||||||||||||||||||||||||
ExtraAttributesForAuthRequest | Login Prompt Option |
|
|
||||||||||||||||||||||||||||||||
UserId | Default User Id (Select after clicking **Generate Token**) |
me
|
|
||||||||||||||||||||||||||||||||
RetryMode | RetryMode |
RetryWhenStatusCodeMatch
|
|
|
|||||||||||||||||||||||||||||||
RetryStatusCodeList | RetryStatusCodeList |
429|503
|
|
||||||||||||||||||||||||||||||||
RetryCountMax | RetryCountMax |
5
|
|
||||||||||||||||||||||||||||||||
RetryMultiplyWaitTime | RetryMultiplyWaitTime |
True
|
|