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:

  1. API URL — Enter the URL of your AccessPoint API service. This must use HTTPS.
  2. Client ID — Enter the Client ID (Application ID) of the API service principal. This must be a valid GUID.
  3. 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.