Setting Up Microsoft Azure Integration

This integration syncs users from your Microsoft 365 tenant into Prosper. You’ll complete part of the setup in Azure, then finish in Prosper.

Part 1 — Azure: register an application

In Azure, register a new application under Microsoft Entra ID → App registrations. From the registered app, grab the following — you’ll paste them into Prosper later:

• Application (client) ID
• Directory (tenant) ID
• Client secret — create one under the App registration and copy the value immediately (Azure only shows it once).

Part 2 — Grant API permissions

On the same app, grant the following Microsoft Graph permissions:

• GroupMember.Read.All
• User.Read
• User.Read.All

Admin consent may need to be granted for these permissions to take effect.

Part 3 — Identify the group(s) to sync

Decide which Azure AD security group(s) contain the users you want in Prosper. For each group:

1. Go to Microsoft Entra ID → Groups → open the group.
2. Copy the Object ID (a GUID, for example a1b2c3d4-5678-90ab-cdef-1234567890ab).

You can sync from one group or several — keep the IDs handy.

Part 4 — Prosper: configure the integration

You’ll need to be signed in to Prosper as an Admin.

1. Go to Integrations → Microsoft.
2. Click Add New Integration.
3. Fill in the fields:
   • Tenant ID — from Azure (Part 1, step 4)
   • Client ID — from Azure (Part 1, step 4)
   • Client Secret — the value you copied when creating the secret
   • Group IDs — comma-separated list of the group Object IDs from Part 3
4. Tick Enable integration if you’d like it active immediately.
5. Click Save integration.

Part 5 — Run the first sync

Once the integration is saved and enabled, a Trigger Full Sync button appears at the bottom of the page. Click it to pull all members from the configured Azure groups into Prosper.

By default, synced members are created as inactive. This is intentional — it lets you review who came across and test the integration without sending invites or affecting billing. You can activate members manually as needed.

If you’d like new members to be activated automatically on sync, reach out to the Prosper support team and we’ll enable that for your tenant.

Troubleshooting

• “Integration connected but no users appear” — almost always missing admin consent. Go back to API permissions in Azure and confirm the green ticks against all three permissions.
• “Invalid client secret” — the secret has either expired or wasn’t copied correctly. Generate a fresh one in Azure and paste it again in Prosper.
• “Group not found” — double-check the Object ID is the group’s ID, not the group name or display name.

Still stuck? Contact [e-mail] and we’ll help you get over the line.