Selected sites lets BidScript read only the SharePoint sites your organisation chooses. A Microsoft admin approves BidScript once, then your SharePoint admin grants it read access to each site, and a BidScript Admin adds those sites to your workspace.
This article covers how to choose Selected sites, how your SharePoint admin grants a site, and how to add, check and remove sites in BidScript.
Where to find it
In the left-hand sidebar, click Settings.
Open Integrations and find the SharePoint admin approval card.
Who does what
Microsoft admin
A Global Administrator or Privileged Role Administrator approves BidScript once for your organisation.
SharePoint admin
Grants BidScript read access to each site. This needs the SharePoint Administrator role or the Sites.FullControl.All permission. BidScript never holds either, so it can't grant itself access to a site.
BidScript Admins
Choose the access level, request approval, and add or remove sites in BidScript. Other roles can see the card but can't change it.
Choosing Selected sites
On the SharePoint admin approval card, under What BidScript can read, select Selected sites.
Click Get admin approval.
Sign in to Microsoft as a Global Administrator or Privileged Role Administrator and accept the request.
When you return to BidScript the card shows the approval date and an empty list of sites. BidScript can't read any site yet. Your SharePoint admin grants each one next.
Note: To move between All sites and Selected sites later, disconnect SharePoint admin approval and approve again with the other option.
Granting BidScript access to a site
Your SharePoint admin grants read access once per site collection. A grant covers the site and every subsite under it. You'll need two things before you start.
The site address, for example https://yourcompany.sharepoint.com/sites/Bids.
The application ID of the BidScript app for selected sites. Find it in the Microsoft Entra admin centre under Enterprise applications once approval is complete, or ask our support team.
Use whichever of the two routes below suits your admin.
With PnP PowerShell
Best for admins who already manage SharePoint from PowerShell.
Connect to the site with
Connect-PnPOnline -Url https://yourcompany.sharepoint.com/sites/Bids -Interactive -ClientId <your PnP app ID>.Run
Grant-PnPAzureADAppSitePermission -AppId <BidScript application ID> -DisplayName "BidScript" -Site https://yourcompany.sharepoint.com/sites/Bids -Permissions Read.Repeat for each site BidScript should read.
Tip: Recent versions of PnP PowerShell also name this command Grant-PnPEntraIDAppSitePermission. Both take the same parameters.
With Graph Explorer
Best where your admin prefers a browser to PowerShell.
Open Graph Explorer and sign in as your SharePoint admin.
Consent to the Sites.FullControl.All permission when Graph Explorer asks for it.
Look up the site ID with a GET request to
https://graph.microsoft.com/v1.0/sites/yourcompany.sharepoint.com:/sites/Bidsand copy the id value from the response.Send a POST request to
https://graph.microsoft.com/v1.0/sites/<site ID>/permissionswith this request body.
{ "roles": ["read"], "grantedToIdentities": [ { "application": { "id": "<BidScript application ID>", "displayName": "BidScript" } } ]}
A successful grant returns the new permission with the role read.
Adding a site in BidScript
On the SharePoint admin approval card, paste the site address into the box under Sites BidScript can read.
Click Add site.
BidScript checks the site with Microsoft before adding it. You can paste the site's home page address, a Teams site address, or a sharing link to any file in the site. If the grant isn't in place yet you'll see a message asking you to check the address and the grant. Once a site is on the list you can sync its libraries as usual.
Searching SharePoint with Selected sites
Search across all of SharePoint isn't available with Selected sites, because Microsoft only allows it for apps that can read every site. Open a site from the list and search inside it instead.
Removing access to a site
To stop BidScript reading a site, ask your SharePoint admin to remove the grant, then remove the site from the list in BidScript.
In BidScript: Click the remove button beside the site on the Sites BidScript can read list.
In SharePoint: Your admin removes the BidScript permission from the site with PnP PowerShell or Graph Explorer.
If the grant is removed first, the site stays on the list and its synced libraries show Access removed after their next sync. Remove the site in BidScript, or ask your admin to grant access again.
What each message means
BidScript can't read this site
The address is wrong, or your SharePoint admin hasn't granted BidScript read access to the site yet.
Access removed
BidScript could read the site before but can't now. Ask your SharePoint admin whether the grant was removed.
We couldn't reach SharePoint to check this site
Microsoft didn't respond in time. Try again in a few minutes.
Best practice
Grant only the sites your bid team draws on, such as the site that holds approved case studies and policies.
Keep a record of which sites you've granted, so you can review them when your bid content moves.
Expect changes in a selected site to reach BidScript within the hour.
Related articles
SharePoint Integration - connecting SharePoint libraries and choosing a sync mode.
Integrations (Settings Overview) - every integration you can manage from Settings.
Creating and Managing Libraries - adding synced SharePoint content to a library.
