Synthesia Notifications for Microsoft Teams - IT Admin Setup

Follow this documentation in order to configure the Synthesia Notifications for Microsoft Teams in your Azure Tenant.

Requirements

An existing Synthesia account on an enterprise plan with a Synthesia Organization
Your Azure Tenant ID
Elevated Global Admin Permissions to admin.teams.microsoft.com
For reference: Synthesia 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 notification. Resolved in real time.
TeamsAppInstallation.ReadWriteSelfForUser.All - Required to install the Synthesia Notifications 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 Notifications

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 Notifications available in your tenant

The Synthesia Notifications app is published to the Teams Store. You will find it listed there to install.
Go to Manage apps: search for Synthesia Notifications.
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 centre → 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 Learn platform (provide your Tenant ID)

As an organization admin in Synthesia:

Go to learn.synthesia.io → Settings → Integrations and select 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.