Connect your Postman account to Microsoft Teams

Connect your Postman account to Microsoft Teams with the Postman app. Install the Postman app in Teams to get started.

Collaborate on API development in Microsoft Teams with the Postman app. You can share enhanced Postman links that you and your teammates can use to take action right in Teams. You can also connect a Postman workspace to Teams to get notified about team activity and communicate workspace updates.

Add the Postman app to Teams

Once you install the Postman app, you can attach Postman elements to posts without leaving Teams and share enhanced Postman links. You can also subscribe to workspace updates.

To add the Postman app to Teams, do the following:

1. Sign in to your Microsoft Teams account.

2. In Microsoft Teams, click + Apps.

3. In Microsoft Teams, click + Apps.

4. Search for "Postman" and select the Postman app in the search results.

5. Click Add to add the Postman app for yourself.

6. Click Add to add the Postman app for yourself.

   You may need approval from a Teams Administrator to install apps in Teams. If approval is required, you are prompted to raise a request with your admin. You can resume the setup process once your Teams Administrator approves the app installation.

7. When prompted how you want to use the app, click Use on your own.

8. Click Sign in to sign in to your Postman account, then click Continue.

9. Click Accept to give Postman permission to view your profile and content in Teams.

Only Postman links shared from the account you sign in with will unfurl in Teams. To sign in with a different Postman account, click View more apps in Teams and select the Postman app. In the chat, enter "sign out". Then enter "sign in" to sign in with the Postman account you want to use.

Unfurl Postman links and take action in Teams

After installing the Postman app, Postman links that you share in Teams are automatically unfurled into rich links. Postman supports rich links for elements such as workspaces, collections, folders, requests, examples, environments, and comments. Postman also supports rich links for HTTP responses.

When you share a Postman link, Teams displays extra information such as the name and type of element and who last updated it. Also, Teams displays options to take action with the element, such as adding a comment, or watching or forking a collection.

Link unfurling isn't available for Postman links shared from workspaces restricted only to you. Change access to your workspace to collaborate in Teams.

Share rich links for HTTP responses

Postman also supports rich links for HTTP responses. Teams displays extra information such as the request URL and response code when you share a Postman link. Teams displays the response body for Postman links shared from team workspaces. For links shared from private or Partner workspaces, Teams doesn't display the response body and you must open Postman to view it. Learn how to share a response.

Link unfurling for HTTP responses isn't available for Postman links shared from workspaces restricted only to you. Change access to your workspace to collaborate on responses in Teams.

Links you share in Teams are pasted as text. To unfurl extra information about an element, a Postman link you share in Teams must be a hyperlink. Click Insert link at the top of the editor, add the text to display, enter the Postman link as the address, then click Insert. You can also add a space after the Postman link to make it a hyperlink.

If the element or HTTP response includes sensitive data, be aware that it might be visible to collaborators you share with in Teams. Make sure to consider the sensitivity of data when deciding which collaborators you share with. Postman recommends checking your organization's policies to understand what qualifies as sensitive data.

You can remove the preview from your message if you're concerned about the data that's shared when a link unfurls. To remove the preview from a sent message, learn about editing a sent message in Microsoft Teams.

Share Postman elements from within Teams

You can find and share Postman workspaces, collections, and requests without leaving Microsoft Teams.

1. In Teams, start or reply to a post and click + Actions and apps.
2. Click the Postman app.
3. Click Workspaces, Collections, or Requests, and then start typing in the search box to find the content your want to share.
4. Select a workspace, collection, or request to add a rich link to your post.

Connect a Postman workspace to Teams

You can connect a Postman workspace to a Microsoft Teams channel. Once you connect the two, Postman sends updates to the Teams channel when someone posts a workspace update, or adds, edits, or deletes a request, collection, or environment. Each update in Teams includes options to take actions, such as adding a comment or watching a collection.

You can connect internal workspaces to Teams. You can't connect other types of Postman workspaces. Learn more about changing workspace visibility. Also, the Teams channel you are connecting to must be a standard channel that's in a public or private Team.

You can establish a connection to a Postman workspace from Microsoft Teams or you can choose to establish the connection to Teams from a Postman workspace.

To connect a Postman workspace from Microsoft Teams, do the following:

1. If you haven't already done so, add the Postman app to Teams.

2. In Microsoft Teams, select + Apps.

3. Search for "Postman" and select the Postman app in the search results.

4. Select Open.

5. Under Or use with others, search for and select the channel you want to send updates to. Then select Go.

6. You're automatically redirected to the Teams channel you selected. On the Postman message card, select Connect.

7. Configure the integration with Postman:

   • Select the Postman workspace you want to send updates from. Start typing in the box to search, then select the workspace when it appears in the list.

     You can also select the workspace by pasting the workspace URL in the box. To get the URL, in Postman, select the workspace name in the sidebar. Then, in the workbench, select Copy link to workspace.

   • Select a Microsoft Teams channel or group chat to connect to from a Postman workspace.

   • Select the notifications you want to get in Teams. You can get notifications when someone adds, edits, or deletes a request, collection, or environment in your Postman workspace.

     

To connect to Microsoft Teams from a Postman workspace, do the following:

1. In Postman, open the workspace you want to connect to Teams.

2. Click Connect in the workspace overview.

   If the workspace Overview tab isn't visible, select the workspace name in the sidebar.

3. Click next to Connect Microsoft Teams.

4. A browser tab opens with a warning that you are being redirected to complete the authorization on the Microsoft site. Click Continue. If the app has been correctly configured in Teams, the authorization is successful and you are redirected back to Postman.

   If this is the first time you're connecting to Microsoft Teams from Postman, you'll get a message telling you to get approval for the Postman app from your Microsoft Teams admin. You can't connect to Teams until the app has been approved. Once the app has been approved for one user from your Postman team, it's approved for all members of your team.

5. In Postman, configure the integration with Teams.

   • Start typing in the Team box to search for the team you want to send updates to, then select the team when it appears in the list.
   • Start typing in the Channel box to search for a channel in the selected Team to send updates to, then select the channel when it appears in the list.
   • Start typing in the Group chat box to search for a group chat in the selected Team to send updates to, then select the group when it appears in the list.
   • Select the notifications you want to get in Teams. You can get notifications when someone posts a workspace update or adds, edits, or deletes a request, collection, or environment in your Postman workspace.

6. Click Connect.

You'll see a message card in the Teams channel or group chat that you are connected to a Postman workspace and a list of updates you'll get in Teams. If you want to change which updates to send to Teams, click Manage notifications.

Edit a Postman workspace's connection to Teams

To make changes to the connection between a Postman workspace and Teams, do the following:

1. Open the workspace's overview and click the Teams icon then click the edit icon next to Teams.

2. You can change the Teams channel or the notifications you want to get in Teams. Click Save to update the integration.

If a channel or a team that you connected to is deleted from Microsoft Teams, you'll get a notification in Postman that it's been deleted. You need to connect another team and channel to resume receiving notifications.

To remove the connection between the Postman workspace and Teams, click Disconnect. You can add the connection again later if you want.

Remove the Postman app for Teams

If you no longer want to use the Postman app for Microsoft Teams, you can remove it from Teams.

1. In Microsoft Teams, click + Apps.
2. Click Manage your apps.
3. Select the Postman app, then click Remove.