- Setup
- Reference
What You'll Need
| Credential | Description |
|---|---|
| Tenant ID | Azure AD tenant identifier |
| Client ID | Application (client) ID |
| Client Secret | Generated client secret |
Overview
Create an Azure AD app registration to connect Parable to Microsoft 365 using OAuth 2.0 client credentials. This enables secure, automated access without user sign-in.Prerequisites
Administrator access required. You need privileges in to complete this setup.If you don’t have admin access, contact your administrator to:
- Create the API credentials on your behalf, OR
- Grant you temporary admin access to complete the setup
- Global Administrator or Application Administrator role in Azure AD
- Permission to grant admin consent for API permissions
Setup Guide
1
Access Azure Portal
- Navigate to Azure Portal
- Go to Azure Active Directory → App registrations
- Click New registration
2
Register Application
| Field | Value |
|---|---|
| Name | Parable Integration |
| Supported account types | Accounts in this organizational directory only |
| Redirect URI | Leave blank (not needed for client credentials) |
3
Note Application Details
From the Overview page, copy:
- Application (client) ID
- Directory (tenant) ID
4
Create Client Secret
- Go to Certificates & secrets
- Click New client secret
- Add description:
Parable Integration Secret - Select expiration (recommend: 24 months)
- Click Add
5
Configure API Permissions
- Go to API permissions
- Click Add a permission → Microsoft Graph
- Select Application permissions
- Add these permissions:
| Permission | Purpose |
|---|---|
User.Read.All | Read all user profiles |
Directory.Read.All | Read directory data |
AuditLog.Read.All | Read audit logs |
Reports.Read.All | Read usage reports |
Mail.Read | Read mail (if needed) |
Calendars.Read | Read calendars (if needed) |
6
Grant Admin Consent
- Click Grant admin consent for [Your Org]
- Confirm the consent dialog
All permissions should show a green checkmark indicating consent was granted.
Need to restrict access?
By default, this grants access to all users in your tenant. See Scoped Access to limit Parable to specific users or teams.