Hiring Assistant for Microsoft Teams enhances recruitment efficiency by helping recruiters on your LinkedIn Recruiter contract share candidate profiles for review in Microsoft Teams. Hiring Assistant shares the feedback hiring managers provide with the recruiter to improve its sourcing strategy.
These FAQs can assist IT and Recruiter admins with authorizing and enabling Hiring Assistant for Microsoft Teams.
IT admins
No. Candidate profile data and hiring manager feedback are not stored in Microsoft Teams or Microsoft systems. Candidate information and feedback are rendered via a secure LinkedIn experience and stored only within LinkedIn systems.
Hiring manager feedback is submitted through a secure LinkedIn experience (embedded within Microsoft Teams) and is stored exclusively in LinkedIn production systems. Feedback is never written to Microsoft Teams storage.
Hiring managers sign in to LinkedIn to ensure they have full candidate profile viewing permissions and can securely submit feedback. Users who are not authenticated to LinkedIn (i.e. “guest” users) have limited profile visibility, which would prevent proper use of the feature.
No. There is no requirement for the hiring manager’s LinkedIn email to match their corporate email.
Recruiters select hiring managers in Microsoft Teams using Entra (Azure AD) identities, while hiring managers authenticate to LinkedIn using their existing LinkedIn profile.
No automatic identity matching is performed between Entra identities and LinkedIn accounts. The Entra identity is used to route the Microsoft Teams message, while LinkedIn authentication is used to grant access to candidate profiles and submit feedback.
Hiring Assistant for Microsoft Teams is hosted by LinkedIn within LinkedIn production infrastructure. This includes a LinkedIn Production resource in Microsoft Entra, plus deployments in LinkedIn’s Azure (Euclid) environment and LinkedIn core data centers.
The LinkedIn Hiring Assistant app needs to be installed from the Microsoft Store in Microsoft Teams Admin. Visit Enable Hiring Assistant for Microsoft Teams - IT and Recruiter admins for more information.
The app requests standard Microsoft Graph permissions to identify users in your tenant (Entra) and deliver notifications in Microsoft Teams. No candidate or recruiting data is accessed from Microsoft.
If a user in LinkedIn Recruiter has successfully logged into Entra, and they can see their own Entra profile information shown near the dropdown list but there are no people typeahead results there, it could be that the corporate IT is blocking traffic to msgraph from LinkedIn related to your Entra tenant.
One such error that we get on the LinkedIn side is: Request was blocked due to a Tenant-Configured UserAgent AllowList being set for this Organization. The UserAgent in the request is LinkedInBot/1.0 (compatible; Mozilla/5.0; Apache-HttpClient http://www.garudax.id).
The corporate Entra tenant may be using an AllowList of UserAgent values and LinkedInBot should be added to that to allow LinkedIn Recruiter to make the msgraph calls for the typeahead.
- /me/people: fetches profiles for the recruiter's coworkers in Entra
- /batch: fetches profile photos
- /me: gets the recruiter's profile
Profiles, profile photos, and the recruiter’s profile information from Entra are received to facilitate user interactions within Recruiter.
LinkedIn stores only the Microsoft Teams ID of the recruiter who is a Hiring Assistant license holder.
All LinkedIn OAuth integrations use the same system to manage tokens and initiate refresh with external partners.
LinkedIn follows the Microsoft Teams Bot Developer guidelines and the LinkedIn externalized API guidelines.
Only basic directory information is accessed, including:
- Display name
- Corporate email address
- Profile photo
- Entra Object ID
This data is used solely to identify the correct user in Microsoft Teams and associate feedback requests with the appropriate recruiter workflow.
LinkedIn stores only the Entra Object ID required to validate and associate feedback requests. No additional directory attributes (such as department, manager, phone number, or org structure) are stored.
The Hiring Assistant integration requires a limited set of OAuth scopes to enable authentication, collaboration, and feedback workflows.
LinkedIn Recruiter (linkedin.com → Microsoft Graph)
Used to support user discovery and authentication from Entra from LinkedIn Recruiter:
- People.Read
- User.ReadBasic.All
- openid
- offline_access
- Chat.Create
- ChatMessage.Send
LinkedIn Hiring Assistant Teams App (Bot → Microsoft Graph)
Used to support authentication, bot installation, and user information from within Microsoft Teams:
- People.Read
- User.Read
- User.ReadBasic.All
- openid
- offline_access
- Chat.Create
- ChatMessage.Send
LinkedIn Hiring Assistant Teams App (Bot → api.linkedin.com)
Used to authenticate users and submit feedback securely:
- r_emailaddress
- Openid
- profile
- r_liteprofile
- r_hiring_candidate_fdbk_3_legged
Important notes
- Permissions are scoped to enable collaboration and feedback only
- All access follows LinkedIn and Microsoft security standards
No. Hiring Assistant for Microsoft Teams is covered under the customer’s existing LinkedIn Hiring Assistant agreement. No additional contracts or amendments are required.
Hiring Assistant for Microsoft Teams adheres to:
- Microsoft Teams Bot Developer guidelines
- LinkedIn externalized API security standards
- LinkedIn internal security and compliance reviews
The LinkedIn Hiring Assistant for Microsoft Teams integration is designed to support hiring collaboration while keeping candidate data and feedback within LinkedIn systems. The steps and diagram below show how data moves between LinkedIn Hiring Assistant, Microsoft Teams, and LinkedIn Recruiter during candidate collaboration.
Step 1: Recruiter initiation and coworker lookup
A recruiter using LinkedIn Recruiter (linkedin.com) decides to share a candidate for feedback to a hiring manager. After 3L OAuth to msgraph, the /me/people endpoint is called to get coworker data from Entra for the typeahead.
OAuth Scopes: People.Read, User.ReadBasic.All, openid, offline_access
Step 2: Teams notification delivery
LinkedIn calls the /api/notify-feedback-requests endpoint on the LinkedIn Hiring Assistant Teams bot in Azure (via x-api-key auth). LinkedIn sends tenantId, oid, and feedbackId, which the bot stores to the Azure Cosmos PostgreSQL DB for pending feedback requests.
Step 3: Hiring manager authentication and request retrieval
Bot uses 3L OAuth flow for the hiring manager in Teams to api.linkedin.com, then fetches the feedback request data and shows an adaptive card with overview info about the feedback request that the hiring manager user clicks to view on LinkedIn.
OAuth Scopes: r_emailaddress, openid, profile, r_liteprofile, r_hiring_candidate_fdbk_3_legged, email
Step 4: Feedback review and submission
Hiring manager clicks to view the feedback request and is shown a TaskModule (iframe) of the feedback page from linkedin.com where they can submit their feedback.
Step 5: Post‑feedback processing
LinkedIn Hiring Assistant updates hiring criteria based on the hiring manager’s feedback (pending the recruiter’s approval).
Recruiter admins
Enablement requires one action from an IT Admin and one from a Recruiter Admin before recruiters can access the Hiring Assistant app in Microsoft Teams and begin sharing candidates.
Visit Enable Hiring Assistant for Microsoft Teams - IT and Recruiter admins to learn more.
With Hiring Assistant for Microsoft Teams, recruiters with a Hiring Assistant license can streamline your hiring workflows by sharing candidate profiles for review directly in Microsoft Teams.
Hiring Assistant for Microsoft Teams can help recruiters streamline collaboration through:
- License flexibility: Hiring managers don’t need a Hiring Assistant license to provide feedback on candidates.
- Candidate calibration: Recruiters can calibrate candidates with hiring managers via Microsoft Teams. Hiring managers receive a notification, sign in, and provide feedback on candidate fit directly in the app.
- Feedback tracking: Hiring Assistant logs feedback activity and offers suggestions to improve hiring requirements for future sourcing rounds.
- Shortlist review: Recruiters send a shortlist of candidates to the hiring manager for review. Hiring managers receive a message in Microsoft Teams to access the list and submit feedback.
- Activity alerts: Hiring Assistant notifies recruiters in the project’s Activity log in Recruiter when the hiring manager submits feedback and adjusts sourcing criteria accordingly.
Recruiters on your contract must have a Hiring Assistant license to send profiles for review in Microsoft Teams. Hiring managers do not need a Recruiter or Hiring Assistant license to view candidates or submit feedback in Microsoft Teams.
To learn more about assigning the Hiring Assistant license, visit Assign a Hiring Assistant license in Recruiter.
After the IT admin installs the app and the Recruiter admin enables it in Recruiter, recruiters can access the Hiring Assistant app directly in Microsoft Teams.
The first time a recruiter shares a candidate’s profile for review through Microsoft Teams in Recruiter, they’ll be prompted to sign in to Microsoft Teams.
Recruiters can access the Hiring Assistant app in the Microsoft Teams mobile app to review candidates.
At this time, recruiters can only chat with Hiring Assistant in Microsoft Teams in English.
Hiring Assistant for Microsoft Teams is included with your LinkedIn Recruiter contract at no additional cost, as long as the recruiter on your contract is assigned a Hiring Assistant license in Recruiter.
Once the IT and Recruiter admins enable the integration for your company, users will automatically have access to the Hiring Assistant app in Microsoft Teams.
If you can’t access the Hiring Assistant app in Microsoft Teams, your IT admin needs to install the app in the Microsoft Teams app store by following the instructions in Enable Hiring Assistant for Microsoft Teams - IT and Recruiter admins.
Related tasks
- Sign in to Recruiter
- Enable Hiring Assistant for Microsoft Teams - IT and Recruiter admins
- Share candidate profiles for feedback in Microsoft Teams with Hiring Assistant
- Provide feedback on candidate profiles in Microsoft Teams
- Disable Hiring Assistant for Microsoft Teams in Recruiter
Learn more
- Hiring Assistant in Recruiter
- Hiring Assistant in Recruiter FAQ
- Hiring Assistant for Microsoft Teams
- Hiring Assistant for Microsoft Teams FAQ
- LinkedIn Hiring Assistant for Microsoft Teams security and compliance
- Hiring Assistant in the LinkedIn Learning Center
- Hiring Assistant Hub in the LinkedIn Talent Community