WorkforceIntegration.ReadWrite.All

Allows the app to manage workforce integrations, to synchronize data from Microsoft Teams Shifts, on behalf of the signed-in user.

Merill's Note

For an app to access data in Microsoft Graph, the user or administrator must grant it the permissions it needs. This article lists all the Microsoft Graph APIs and your tenant data that can be accessed by the application (vendor/developer) if you consent to the WorkforceIntegration.ReadWrite.All permission.

If you need to create an audit report of the permissions granted to all the apps in your tenant, you can run the Export-MsIdAppConsentGrantReport command. See How To: Run a quick OAuth app audit of your tenant

Category	Application	Delegated
Identifier	202bf709-e8e6-478e-bcfd-5d63c50b68e3	08c4b377-0d23-4a8b-be2a-23c1c1d88545
DisplayText	Read and write workforce integrations	Read and write workforce integrations
Description	Allows the app to manage workforce integrations to synchronize data from Microsoft Teams Shifts, without a signed-in user.	Allows the app to manage workforce integrations, to synchronize data from Microsoft Teams Shifts, on behalf of the signed-in user.
AdminConsentRequired	Yes	Yes

Graph Methods

• API [v1.0]
• API [beta]
• PowerShell [v1.0]
• PowerShell [beta]

→ API supports delegated access (access on behalf of a user)
→ API supports app-only access (access without a user)

	Methods
	DELETE /teamwork/workforceIntegrations/{workforceIntegrationId}
	GET /teamwork/workforceIntegrations
	GET /teamwork/workforceIntegrations/{workforceIntegrationId}
	PATCH /teamwork/workforceIntegrations/{workforceIntegrationId}
	POST /teamwork/workforceIntegrations

Resources

Granting this permission allows the calling application to access (and/or update) the following information in your tenant.

• workforceIntegration
• workforceIntegrationEncryption

Graph reference: workforceIntegration

Property	Type	Description
apiVersion	Int32	API version for the callback URL. Start with 1.
createdDateTime	DateTimeOffset	The date and time at which this workforceIntegration was first created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Inherited from changeTrackedEntity.
displayName	String	Name of the workforce integration.
eligibilityFilteringEnabledEntities	eligibilityFilteringEnabledEntities	Support to view eligibility-filtered results. Possible values are: none, swapRequest, offerShiftRequest, unknownFutureValue, timeOffReason. Use the Prefer: include-unknown-enum-members request header to get the following value in this evolvable enum: timeOffReason.
encryption	workforceIntegrationEncryption	The workforce integration encryption resource.
isActive	Boolean	Indicates whether this workforce integration is currently active and available.
supportedEntities	workforceIntegrationSupportedEntities	The Shifts entities supported for synchronous change notifications. Shifts call back to the provided URL when client changes occur to the entities specified in this property. By default, no entities are supported for change notifications. Possible values are: none, shift, swapRequest, userShiftPreferences, openShift, openShiftRequest, offerShiftRequest, unknownFutureValue, timeCard, timeOffReason, timeOff, timeOffRequest. Use the Prefer: include-unknown-enum-members request header to get the following values in this evolvable enum: timeCard , timeOffReason , timeOff , timeOffRequest.
url	String	Workforce Integration URL for callbacks from the Shifts service.