Sync Settings

Configure and monitor the presence sync process -- enable/disable sync, view job history, and troubleshoot integration health.

The sync settings page lets you control the presence data sync process and monitor its health.

Accessing Sync Settings

Navigate to Settings → Presence → General Settings → Sync Settings in the Pult Dashboard.

Enabling and Disabling Sync

The main toggle on this page controls whether the WiFi Presence sync is enabled or disabled.

Enabled: Pult periodically polls your WiFi controllers and MDM systems for data, processes matches, and records presence.
Disabled: All polling stops. No new WiFi Presence data is collected. (The Pult Agent operates independently and is not affected by this toggle.)

Before enabling sync, ensure you have at least one WiFi integration and one MDM integration (or manual device list) configured. Sync cannot run without data sources.

Integration Health

The sync settings page shows the overall health of your integrations:

Status	Meaning
All integrations working	All WiFi and MDM integrations are connected and syncing successfully.
Needs integrations	No WiFi or MDM integrations are configured. Add integrations before enabling sync.
Paused	One or more integrations have been automatically paused due to repeated authentication failures.

Automatic Pause (Tainted Backends)

If an integration (WiFi or MDM) encounters repeated authentication failures, it is automatically paused to prevent account lockouts and unnecessary API calls.

When an integration is paused:

It is skipped during sync cycles.
The dashboard shows a warning on the integration's status card.
An admin must resolve the underlying issue (e.g., update expired credentials) and re-enable the integration.

Common causes of authentication failures:

Expired API tokens or secrets -- Regenerate credentials in the provider's dashboard and update them in Pult.
Changed passwords -- Update the service account password in both the provider and Pult.
Revoked API access -- Re-authorize the integration (especially relevant for OAuth-based integrations like Intune).

Sync Job History

The sync settings page includes a collapsible Sync Jobs section showing recent sync runs.

Each sync job entry shows:

Timestamp -- When the sync started.
Duration -- How long the sync took.
Status -- Whether the sync completed successfully or encountered errors.
Details -- Expandable logs with step-by-step information about what happened during the sync.

This history is useful for:

Verifying that sync is running on schedule.
Diagnosing why presence data might be missing or delayed.
Checking whether specific integrations reported errors.

Triggering a Manual Sync

For immediate testing, you can trigger a sync from the WiFi Inspector page using the Trigger WiFi Activity Sync button. This runs a full sync cycle on demand and shows results in real time.