Directorysync
Overview
Directorysync lets you run or queue directory syncs that import people and account data from supported external systems into your organization: Google Workspace, Microsoft, Slack, and Salesforce.
Each sync is an organization-scoped job. Choose the provider, confirm the provider is authorized for your organization, then start the sync using the action shown for that provider.
- Google Workspace and Microsoft use the Connect and run action and require organization-level authorization. They can be blocked until an admin grants one-time directory access.
- Slack and Salesforce use the Queue sync action. Slack uses a member-level connection, so the connected Slack account of the person who queues the sync matters; Salesforce uses an organization-level connection.
When to use Directorysync
Use Directorysync when you need to pull directory data into the product from an external source:
- To perform an initial import from Google Workspace, Microsoft, Slack, or Salesforce
- To run a manual refresh after an access change or a change in source data
- To queue a Slack or Salesforce sync when you have the appropriate connection
- To confirm whether a provider is ready before relying on it as a source
How it works
- Choose a provider: Google Workspace, Microsoft, Slack, or Salesforce.
- The system checks provider readiness for your organization. This includes whether the provider is supported and whether required authorization or admin consent is in place.
- Start the sync using the action shown for the provider:
- Click Connect and run for Google Workspace or Microsoft
- Click Queue sync for Slack or Salesforce
- The system creates an organization-level sync job that records the run and its source provider.
Google Workspace and Microsoft require organization-level consent from the appropriate admin before their Connect and run syncs can proceed. If consent is missing, the UI displays the disconnect reason and prevents the run until the admin grants access.
Slack uses a member-level connection. The person queuing the sync should have the Slack account connected to the product. Salesforce uses an organization-level connection and is queued with Queue sync.
Typical workflow
- Open the Directorysync or Integrations area for your organization.
- Select the provider you want to sync: Google Workspace, Microsoft, Slack, or Salesforce.
- Confirm provider readiness:
- For Google Workspace and Microsoft, verify that an admin has granted the required one-time directory access.
- For Slack, ensure the member who will queue the sync has a connected Slack account.
- Start the sync:
- Click Connect and run for Google Workspace and Microsoft.
- Click Queue sync for Slack and Salesforce.
- Monitor the organization sync job and review results when the job completes.
- Repeat when you need another pull or after changing access or source data.
Fields, controls, and labels
| Item | Meaning | Notes |
|---|---|---|
| Google Workspace | Directory source for Google environments | Action: Connect and run. Organization-level connection. Disconnected reason shown: "A Google Workspace admin needs to grant one-time directory access before this sync can run." |
| Microsoft | Directory source for Microsoft environments | Action: Connect and run. Organization-level connection. Disconnected reason shown: "A Microsoft admin needs to grant one-time directory access before this sync can run." |
| Slack | Directory source via Slack integration | Action: Queue sync. Uses a member-level connection (the connected member account matters). |
| Salesforce | Directory source via Salesforce integration | Action: Queue sync. Uses an organization-level connection. |
| Connect and run | Starts a connection-backed organization-level sync | Used for Google Workspace and Microsoft. |
| Queue sync | Creates an organization sync job | Used for Slack and Salesforce. |
Automation and downstream behavior
- The system enforces connection modes: organization-level vs. member-level.
- Each sync run is recorded as an organization-scoped job.
- Google Workspace and Microsoft syncs are blocked until the required admin consent is granted.
- Follow-up processing (for example, post-sync notifications or downstream consumers of the imported directory data) runs after the job completes. Notify reviewers or stakeholders according to your internal process.
Things to watch for
- Google Workspace and Microsoft syncs will not run until the appropriate admin grants one-time directory access.
- Slack uses a member-level connection. The person queuing the sync must have the correct Slack account connected.
- Use the action label shown for each provider: Connect and run for Google/Microsoft, Queue sync for Slack/Salesforce.
- If a provider is not ready, resolve the connection or consent issue before retrying the sync.