Initial setup — connecting to the API, verifying tenant configuration, and notification settings
Last updated: March 29, 2026 by Steve
Initial Setup
The Setup screen configures the connection between AccessPoint and the backend API, and controls how notifications are delivered to users.
[Screenshot: The Setup panel showing the API connection fields and notification settings]
API Connection
Configure the connection to the AccessPoint API:
- API URL — Enter the URL of your AccessPoint API service. This must use HTTPS.
- Client ID — Enter the Client ID (Application ID) of the API service principal. This must be a valid GUID.
- Click Save to store the connection settings.
Notification Settings
[Screenshot: The notification configuration section showing email and Teams toggles]
Email Notifications
- Enable/Disable Email Notifications — Use the toggle to turn email notifications on or off for the entire system.
- Notification Sender Mailbox — Set the email address that notifications are sent from. This must be a shared mailbox or user mailbox in your Microsoft 365 tenant (e.g.,
noreply@contoso.com). - Click Validate Mailbox to verify that the API service principal has permission to send from the specified mailbox.
Teams Activity Feed Notifications
Teams activity feed notifications are off by default and must be explicitly enabled.
When enabled, users receive notifications directly in their Microsoft Teams activity feed, in addition to (or instead of) email notifications.
Required Permissions
The following Microsoft Graph permissions must be granted to the relevant service principals for notifications to work:
API Service Principal
| Permission | Purpose |
|---|---|
Mail.Send |
Send email notifications |
User.Read.All |
Resolve user information |
TeamsAppInstallation.ReadForUser.All |
Check Teams app installation status |
Application.Read.All |
Read application registrations |
AppCatalog.Read.All |
Read the Teams app catalog |
Realizer Multi-Tenant Enterprise App
| Permission | Purpose |
|---|---|
TeamsActivity.Send |
Send Teams activity feed notifications |
AppCatalog.Read.All |
Read the Teams app catalog |
User.Read |
Read basic user profile |
These permissions are configured during the deployment process and are required for notification delivery to function correctly.