> For the complete documentation index, see [llms.txt](https://docs.wrangle.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wrangle.io/tickets/getting-started-with-wrangle/installing-wrangle-in-teams.md).

# Installing Wrangle in Teams

Connect Wrangle to your Teams tenant to start managing tickets directly from Teams. This setup takes just a few minutes.

### Installation Steps

#### Step 1: Sign in to Wrangle

Go to [Wrangle](https://app.wrangle.io/) and click **Log In with Teams**.

<figure><img src="https://3500333410-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8Mly5TzbK30rAk6_PN%2Fuploads%2FYv7o5qiwjD4gDG2Tr5U1%2FScreenshot%202026-03-16%20at%209.14.17%E2%80%AFAM.png?alt=media&amp;token=746c9f30-8b69-4965-a97d-23dbca6926fd" alt="Wrangle sign-in page"><figcaption></figcaption></figure>

#### Step 2: Authorize Wrangle in Teams

<figure><img src="https://3500333410-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8Mly5TzbK30rAk6_PN%2Fuploads%2FySNnHZ7lV9ptHoTLqsNJ%2Foauth.png?alt=media&amp;token=1ad5a72f-568f-4f54-886b-518e1f5ae247" alt=""><figcaption></figcaption></figure>

You'll be redirected to Teams to authorize the connection.

1. Review the permissions Wrangle is requesting
2. Click **Accept** once satisfied

#### Step 3: Add Wrangle To Teams

After authorizing, you'll be redirected back to Wrangle to continue the installation process:

<figure><img src="https://3500333410-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8Mly5TzbK30rAk6_PN%2Fuploads%2FwfyvbBK7ECgeETHJZAT4%2FAdd_wrangle_to_teams.png?alt=media&amp;token=21392ee0-c7b7-4275-89db-b5b5d8491db8" alt=""><figcaption><p>Adding Wrangle to Teams</p></figcaption></figure>

You'll be directed to [Open Wrangle](https://teams.microsoft.com/l/app/9b150bf6-a0cf-4b8b-8684-7bcdd0c60eeb) in the Teams App Store. You can alternatively visit Apps in Teams and search for Wrangle.\
\
After clicking **Add**, make sure you select a channel to use with Wrangle before continuing, as shown below:

<figure><img src="https://3500333410-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8Mly5TzbK30rAk6_PN%2Fuploads%2FMa95lvHvbUEuUHdljZ1l%2FScreenshot%202026-04-20%20at%2010.14.10%E2%80%AFAM.png?alt=media&amp;token=40658dd1-8211-42ea-9ec5-78335ff7c619" alt=""><figcaption><p>Select a channel to use Wrangle within Microsoft Teams</p></figcaption></figure>

Once you have selected your channel, click **Go**.

\
Once you are done, click `I have installed Wrangle in Teams` to continue to Wrangle.<br>

#### Step 4: Approve Wrangle for your Organization

When installing Wrangle, you'll see one final authorization screen that requires a Teams admin to continue:

<figure><img src="https://3500333410-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8Mly5TzbK30rAk6_PN%2Fuploads%2FJMsbEXxtPQUitA8stRvL%2FScreenshot%202026-05-11%20at%208.07.16%E2%80%AFAM.png?alt=media&amp;token=c1da11f3-0661-40be-b6e8-2970ef005f94" alt="Additional Permissions Required screen"><figcaption><p>Ask a Teams Admin to grant Wrangle permission for your organization</p></figcaption></figure>

You'll be redirected to Teams to authorize the connection.

1. Review the permissions Wrangle is requesting
2. Click **Accept** once satisfied

\
\
That's it! You're now ready to [create your first inbox](/tickets/getting-started-with-wrangle/wrangle-for-teams.md) to manage your tickets with Wrangle.<br>

{% hint style="info" %}
We take privacy seriously. [Wrangle is **SOC2 certified**](https://www.wrangle.io/security), so you can trust that your data is secure.
{% endhint %}

####

#### How to Add Wrangle to a specific Team

If you run into an error verifying your installation or selecting a Team for use within an inbox, ensure you've added Wrangle to your Team.\
\
You can do this following these steps:\
\
1\. [Open the Wrangle app within Teams](https://teams.microsoft.com/l/app/9b150bf6-a0cf-4b8b-8684-7bcdd0c60eeb)

<figure><img src="https://3500333410-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8Mly5TzbK30rAk6_PN%2Fuploads%2Fi57wabZ89Licfx87QVbF%2Fwrangle_in_teams.png?alt=media&amp;token=0d0b2149-3813-48c5-b467-4981a0450ff0" alt="Select Wrangle from your Apps in Teams"><figcaption></figcaption></figure>

2. Click the `Open` button and make sure to **Select a channel** in the menu shown below.

<figure><img src="https://3500333410-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8Mly5TzbK30rAk6_PN%2Fuploads%2FJo21tf5FB4TH1aucJmTF%2FScreenshot%202026-03-16%20at%2010.42.44%E2%80%AFAM.png?alt=media&amp;token=24f9096b-6c47-41d8-99af-e7a08330a9e6" alt="Select a channel in Teams" width="253"><figcaption></figcaption></figure>

3. Once you have selected your channel as shown above in Step 2, click `Go`.<br>

That's it! Wrangle is now available for use within your Team.