Microsoft Teams

Synthesia Teams Notification App - IT Admin Setup

Follow this documentation in order to configure the Synthesia Teams Notification Application in your Azure Tenant

Requirements

• Your Azure Tenant ID
• Elevated Global Admin Permissions to admin.teams.microsoft.com
• Synthesia Teams App Client ID: 1cce8fd8-8ddb-4759-8109-3668bf22db8b

Permissions Required via the Teams app

• User.Read.All - Required to fetch end user email who will receive the Synthesia Teams notification. Resolved in real time
• TeamsAppInstallation.ReadWriteSelfForUser.All - Required to install the Synthesia Teams application on the end users instance of Teams
• AppCatalog.Read.All - Required to resolve to the correct Teams App Store Identifier within your tenancy

1. Grant consent to Synthesia Teams Notification App

• Sign in as a Global Admin and open the consent URL below. Synthesia's client ID is already filled in; the /common endpoint applies the consent to whichever tenant you sign in with, so no tenant ID is needed
  • https://login.microsoftonline.com/common/adminconsent?client_id=1cce8fd8-8ddb-4759-8109-3668bf22db8b
• OR: pin it directly to your tenant by replacing {yourTenantId}
  • https://login.microsoftonline.com/{yourTenantId}/adminconsent?client_id=1cce8fd8-8ddb-4759-8109-3668bf22db8b
• Approve, then confirm all three application permissions (User.Read.All, TeamsAppInstallation.ReadWriteSelfForUser.All, AppCatalog.Read.All) show as granted.

2. Make the Synthesia app available in your tenant

• The Synthesia app is published to the Teams Store. You will find it listed there to install
• Go to Manage apps: search for Synthesia
• Set the app status to Allowed
• make it available to the relevant users (Everyone, or a group)

Microsoft Graph can only install an app that's available from the Teams Store, so the per-user install (and therefore every message) fails until the app is allowed.

3. Ensure target users have Teams chat enabled

• Each user who should receive notifications must have 1:1 chat enabled on their Teams account.
• Chat is governed by the messaging policy assigned to the user (Teams admin center → Messaging policies → the user's policy → Chat = On)
• Also if your org uses it, by role-based chat permissions (a user on a Restricted chat role cannot be messaged by a bot).

If a user lacks chat permissions, the bot can't open the 1:1 conversation and delivery fails at thread creation with 403 "Failed to execute Skype backend request CreateThreadS2SRequest" even when consent and app availability are correct.

4. (Optional) Pin the app

Add the app to the global app setup policy to surface it for users. Note: this only pins/showcases the app

5. Connect Teams in Synthesia (provide your Tenant ID)

As an organization admin in Synthesia:

• Go to learn.synthesia.io → Settings → Integrations and click Connect on Teams.
• The only value you enter is your Tenant ID. find it in Entra → Overview.

Troubleshooting

Any problems with your configuration, be sure to reach out to Synthesia Support