✅ Step 1: Create an App Registration
Go to the Azure Portal.
Navigate to Microsoft Entra ID > Manage (sidebar) > App registrations.
Click “+ New registration”.
Set the following:
Name: Pebb Integration (or any name you prefer)
Supported account types: Select Accounts in this organizational directory only
Leave the redirect URI blank (Pebb does not require this for app-level auth)
Click Register.
🔑 Step 2: Generate a Client Secret
After creating the app, go to Manage (sidebar) > Certificates & secrets.
Under Client secrets, click “+ New client secret”.
Add a description (e.g., Pebb access key) and select 24 months.
Click Add.
Copy the secret value immediately and store it somewhere safe. You’ll need to send this to Pebb.
📚 Step 3: Assign API Permissions
Go to Manage (sidebar) > API permissions > Add a permission.
Choose Microsoft Graph.
Select Application permissions.
Search and add:
User.Read
Directory.Read.All
Click Add permissions.
Click Grant admin consent and confirm.
📤 Step 4: Send the Following to Pebb
Please send us over the following details:
Tenant ID
Client ID (Application ID)
Client Secret (from Step 2)
🔁 What Happens Next?
Once you complete these steps, Pebb will automatically sync your employee directory daily via Microsoft Graph API. You can revoke access or rotate the secret anytime by updating your Azure app.