web
You’re offline. This is a read only version of the page.
close
Skip to main content

Announcements

News and Announcements icon
Community site session details

Community site session details

Session Id :
Power Platform Community / Forums / Copilot Studio / Publishing Copilot Stu...
Copilot Studio
Suggested Answer

Publishing Copilot Studio Agents but add gives error

(1) ShareShare
ReportReport
Posted on by 62
Setup
 
- Agent built in the new Copilot Studio experience (GitHub Copilot harness)
- Agent is published successfully (live version exists)
- Teams + Microsoft 365 channel is connected, with "Make agent available in Microsoft 365 Copilot" enabled
- Agent is shared with one individual user via the Share panel, org-wide access is off ('No permissions, unless specified')
- Authentication: default "Authenticate with MSFT"
 
What happened
1. I then use link from the Teams channel configuration panel (Availability options → Copy link, a teams.microsoft.com/l/app/... deep link). The Teams install dialog opens correctly and shows the agent's name and icon, but clicking **Add** fails with: "Something went wrong and we couldn't add the agent."
2. The exact same error occurs in the Teams web client in a private/incognito window, so client-side cache is ruled out.
Since the install dialog resolves with the correct name and icon, the app catalog entry clearly exists, but it appears to be half-provisioned or stale, so the install transaction itself fails.
 
**Questions**
1. Is full channel removal + re-add the correct and safe fix for this in the new experience, or does it risk leaving a duplicate/orphaned app entry in the tenant catalog?
2. Is this a known provisioning issue with the new experience's Teams + M365 channel?
3. If channel re-creation doesn't help, what exactly should Teams admin check under Manage apps (app status, app permission policies, Power Platform apps blocked?), and is the workaround of disabling and re-enabling the app in Teams admin center still the recommended path for this error?

- Vektori
  • Suggested answer
    sannavajjala87 Profile Picture
    1,113 Super User 2026 Season 2 on at

    Hi,

    It sounds like the app is being discovered correctly since Teams can resolve the agent name and icon. That usually points to a provisioning or installation issue rather than a publishing problem.

    Recreating the Teams/M365 channel is generally a safe first step and shouldn't create duplicate agents. If that doesn't help, ask your Teams admin to check:

    • That the app isn't blocked in Manage apps

    • App permission policies for the affected user

    • Any restrictions on Power Platform or Copilot apps

    • Whether other shared users can install the agent

    I've also seen cases where republishing the agent or disabling and re-enabling the app in Teams Admin Center helps refresh a stale app registration. Since the issue occurs in an incognito session too, I'd focus on Teams app provisioning and admin policies rather than browser caching.

    Thanks & Regards,

    Manoj Annavajjala

  • Suggested answer
    11manish Profile Picture
    4,802 Super User 2026 Season 2 on at
    I would classify the problem as:

    Copilot Studio agent is successfully published and discoverable, but the Teams app installation/provisioning transaction is failing.

    Therefore, Teams Admin Center policies and app status should be investigated before changing the Copilot Studio channel.

    Also, don't assume that recreating the channel is a guaranteed fix or that it is a confirmed Microsoft bug. It is better treated as a controlled remediation step after
     
    Teams-side validation.
  • Vektori1 Profile Picture
    62 on at
    @sannavajjala87

    Additional information:
    - We are not using unified application management.
    - Using Copilot Studio New experience
    - Teams admin center: Agent is not visible
    - admin.cloud.microsoft (M365 Admin center, Agent is visible), status: available, no blocks
    - Agent Is orchestrator agent, with 3 - sub agents connected to it.
    - Sub agents are not published to channel individually.

    1. The agent is not visible in 'Manage apps'
    2. App permission policies for the affected user, No permission blockers.
    3. No restrictions: Any restrictions on Power Platform or Copilot apps
    4. Whether other shared users can install the agent = No
     
  • Suggested answer
    chiaraalina Profile Picture
    2,553 Super User 2026 Season 2 on at
     
    If you want to use the Teams channel and distribute the agent to shared users via the installation link, I would check that "Let users interact with custom apps in preview" is enabled in Teams Admin Center.
     

    Teams admin center → Teams apps → Manage apps → Actions → Org-wide app settings → Custom app

     
     
    But be careful (Governance): If this setting is turned on, makers can distribute Copilot Studio agents to shared users via direct links without Teams admin approval. You can limit this with Managed Environment sharing limits (Editor/Viewer sharing rules and per-agent viewer caps).
     
    Publishing an agent to Built for your org still requires admin approval (in the Admin Center). 
     
    Hope it helps!
     
     
  • Vektori1 Profile Picture
    62 on at
    @chiaraalina

    I will test this out and let you know how it works.

    - Vektori
  • Vektori1 Profile Picture
    62 on at
     
    We had the setting on, but still it wont work. Publishing new agents using new experience wont work at all.
  • Suggested answer
    Valantis Profile Picture
    7,545 Super User 2026 Season 2 on at
     
    Given that the agent isn't visible in Teams Admin Center Manage apps at all (only in M365 Admin Center), the Teams app registration for the GitHub Copilot harness agent is either incomplete or not syncing to Teams app catalog the same way classic harness agents do.

    This appears to be a known gap with the new GitHub Copilot harness. Unlike the standard harness which registers a Teams app that shows up in Manage apps, the new harness uses a different publishing path that may not fully provision the Teams side in all tenants yet.

    What to try next: in Copilot Studio, go to Channels, remove the Teams + M365 channel entirely, wait 5 minutes, re-add it and republish. This forces a fresh app registration attempt. Check Teams Admin Center immediately after to see if the app now appears in Manage apps.

    If the app still doesn't appear in Manage apps after channel re-creation, this needs a Microsoft Support ticket. The fact that no shared users can install it and it's invisible in Teams Admin Center points to a backend provisioning failure that only Microsoft can resolve. Include your tenant ID, the agent's environment ID, and confirm you're using the GitHub Copilot harness in the ticket.
     
      Best regards,

    Valantis   ✅ If this helped solve your issue, please Accept as Solution so others can find it quickly.

    ❤️ If it didn’t fully solve it but was still useful, please click “Yes” on “Was this reply helpful?” or leave a Like :).

    🏷️ For follow-ups  @Valantis.

    📝 https://valantisond365.com/ 💼 LinkedIn   ▶️ YouTube
  • Suggested answer
    M Bilal Khan Profile Picture
    376 on at

    HI @Vektori1,

    This looks more like a Teams app provisioning/catalog synchronization issue than a Copilot Studio publishing failure.

    The fact that:

    • the agent publishes successfully,
    • the Teams installation link opens,
    • the correct agent name/icon are displayed,
    • and the failure happens specifically when clicking Add

    is a useful distinction. The agent itself appears to be published, but the Teams installation transaction is failing.

    Microsoft's current Copilot Studio documentation confirms that the installation link is the supported way to share an agent with users, and that users must have access to the agent before they can install it. It also requires the tenant to allow Power Platform apps to be added to Teams.

    I would troubleshoot it in this order.

    1. Check the Teams app in Teams Admin Center

    Ask the Teams administrator to go to:

    Teams admin center → Teams apps → Manage apps

    Search for the agent and check:

    • App status — Allowed
    • Whether the app is blocked by an app permission policy
    • Whether the user is covered by a policy that restricts Power Platform apps
    • Whether the app is available to the affected user
    • Whether there are multiple/stale entries for the same agent

    Microsoft specifically states that organizations must allow Power Platform apps to be added to Teams for users to install Copilot Studio agents directly or find them under Built with Power Platform.

    2. Try the documented Teams-side refresh

    There is actually a Microsoft-documented workaround for cases where Teams continues using an older published configuration.

    In Teams admin center:

    Manage apps
       ↓
    Find the agent
       ↓
    Disable
       ↓
    Wait briefly
       ↓
    Enable again
    

    Then in Copilot Studio:

    Channels
       ↓
    Microsoft Teams / Microsoft 365
       ↓
    Turn the channel off
       ↓
    Save
       ↓
    Turn the channel back on
       ↓
    Publish again
    

    Microsoft documents this sequence for a SystemError caused by Teams retaining a previously published version of the agent.

    There is also a recent Microsoft Q&A report describing a very similar Teams Add → error after republishing scenario, where the Teams app package/manifest was out of sync with the newly published agent.

    3. I would not immediately remove/recreate everything

    Removing and re-adding the Teams channel is supported, but I would use it as the next step rather than the first one.

    Microsoft documents that you can:

    Remove channel → Disconnect → Add channel again → Publish

    and explicitly says that reconnecting the Teams channel is supported. If the agent is still installed when you reconnect it, Teams can show Update now instead of Add.

    So I wouldn't expect channel recreation by itself to create an intentional duplicate app. However, if the tenant already has an app/catalog entry that is stale, I'd clean that up through the Teams admin side rather than repeatedly creating/removing channels.

    4. Check the user's actual access

    You mentioned the agent is shared with one individual user.

    That's important because Microsoft's documentation states that only users who can access the agent can use the installation link.

    For a clean test, temporarily verify that:

    Agent access
        ↓
    Affected user explicitly shared
        ↓
    User signs into Teams with same account
        ↓
    Installation link opened in Teams web
    

    If the same user can see the correct installation dialog but Add still fails, that makes an access/permission problem less likely and strengthens the Teams app provisioning hypothesis.

    What I would do in this case

    Given the symptoms, my sequence would be:

    Copilot Studio
          ↓
    Confirm published agent
          ↓
    Confirm user has access
          ↓
    Teams Admin Center → Manage apps
          ↓
    Check Allowed / policies / stale entry
          ↓
    Disable app
          ↓
    Re-enable app
          ↓
    Turn Teams channel off/on in Copilot Studio
          ↓
    Republish
          ↓
    Retry installation link
    

    I would not assume that the teams.microsoft.com/l/app/... link itself is broken. The fact that it resolves the correct agent metadata suggests that Teams can locate the app; the failure is occurring later in the installation/provisioning transaction.

    If the same error remains after the Admin Center refresh, I'd capture the failed Add request from Teams and raise it with Microsoft, providing the Agent ID/App ID, Environment ID, tenant ID, timestamp, Teams client (web/desktop), and the Teams Admin Center app status.

    So yes, disabling/re-enabling the app in Teams Admin Center is a reasonable supported troubleshooting step, and I'd try that before completely recreating the channel. Microsoft has documented essentially this refresh pattern for stale Teams agent configuration.

Under review

Thank you for your reply! To ensure a great experience for everyone, your content is awaiting approval by our Community Managers. Please check back later.

Helpful resources

Quick Links

Season of Sharing Community Challenge Winners!

Congratulations to our community stars!

Kudos to our 2025 Community Spotlight Honorees

Expanding mentorship, skilling, and AI innovation

Leaderboard > Copilot Studio

#1
Mohsin Ali Profile Picture

Mohsin Ali 360

#2
Valantis Profile Picture

Valantis 253 Super User 2026 Season 2

#3
11manish Profile Picture

11manish 184 Super User 2026 Season 2

Last 30 days Overall leaderboard