Copilot studio agent publishing error when adding a teams channel

Question

Copilot studio agent publishing error when adding a teams channel

Ami Dudu 0

We are developing an AI agent for the Microsoft platform, we build a custom connector in Power Automate and built and agent using Copilot studio. We want to push this agent as an app for Teams for our clients. The app is working with oAuth and need to use the end user credentials and support multi-tenant (using the client's copilot credit plan). We are facing issues when we try to create a teams channel, we tried a lot of options which didn't work and currently facing an error when trying to publish the the copilot studio agent if teams channel is active, we are getting:

[
  {
    "componentDisplayName": "Agent Errors",
    "diagnosticResult": [
      {
        "$kind": "BotSynchronizationError",
        "errorCode": "SynchronizationSystemError",
        "isFatal": true,
        "errorMessage": "Synchronization error with code 'SynchronizationSystemError'"
      }
    ],
    "errorDescription": "There is an error: 'SynchronizationSystemError'",
    "diagnosticErrorCount": 1
  }
]

looking for someone which can guide and help, AI tools didn't help so much finding the root cause and fixing the problem.

Karan Shewale 2,385 Reputation points Microsoft External Staff

2025-12-11T12:27:16.4233333+00:00

Thanks for bringing this issue to our attention. We will check and update you soon.

2 answers

Your answer

Karan Shewale 2,385 Reputation points Microsoft External Staff

2025-12-11T12:27:16.4233333+00:00

Thanks for bringing this issue to our attention. We will check and update you soon.

Answer 1

The error you are encountering, SynchronizationSystemError, suggests that there may be issues with the synchronization process between your Copilot Studio agent and the Teams channel. Here are a few steps you can take to troubleshoot this issue:

Check Data Policies: Ensure that the data policies in your tenant allow for the necessary channels to be published. If there are restrictions, you may need to contact your Power Platform admin to review and potentially adjust these policies.
Review Connector Policies: Since you are using a custom connector, verify that there are no connector policies blocking the integration with Teams. Your admin can check this in the Power Platform admin center.
Environment Requirements: Make sure that the environment where you are trying to publish the agent meets all the necessary requirements. If the environment is blocked from publishing, it could lead to synchronization errors.
Error Details: Utilize the Show raw option to get detailed error information in JSON format. This can provide more insights into what specifically is causing the synchronization error.
Support Resources: If the issue persists, consider reaching out to Microsoft Support for technical assistance or consult the Power Platform Community forums for additional insights from other users who may have faced similar issues.

By following these steps, you should be able to identify and resolve the synchronization error when publishing your agent with the Teams channel.

Answer 2

Hi Ami,

This error typically appears when the Copilot agent cannot sync properly with the Teams channel during publishing. In most cases, the failure is caused by environment restrictions or tenant policies blocking the channel setup. Start by confirming that your Power Platform environment is allowed to publish agents to Teams, and check that no Data Loss Prevention (DLP) or connector rules are blocking your custom connector. Because your agent uses OAuth and relies on the end user’s credentials, make sure the custom connector is permitted in the environment and not restricted under governance policies.

You should also verify that the environment has the correct bot registration and service principals configured. Missing or mismatched bot IDs often trigger synchronization failures. When reviewing the Show raw JSON, look for errors related to bot registration or failed Graph API calls—these usually signal backend provisioning issues. If publishing only fails when the Teams channel is enabled, it’s likely a system-side issue. In that case, share the full diagnostic JSON, environment ID, and publish timestamp with Microsoft Support so they can trace the backend error.

Relevant Documentation:

Thank you.

Karan Shewale.

If this response resolves your issue, please Accept the answer and, if helpful, click the “Upvote” button. Your feedback helps us improve and assist others more effectively.

Share via

Copilot studio agent publishing error when adding a teams channel

2 answers

Your answer