microsoftgraph / microsoftgraph/msgraph-bicep-types

Add the ability to invite guest users from other tenants in Bicep

Open
#226 5 comments 3 reactions 1 assignee View on GitHub

@dkershaw10 is already working on this.

Since Apr 23, 2025.

enhancement new type triaged
Dominant language
TypeScript
Stars
80
Forks
15
Avg merge
1h 21m
Merged PRs (30d)
3

Description

Vote for this new type by clicking the thumbs-up.

Is your feature request related to a problem? Please describe.

I am a Cyber Engineer at a Microsoft partner MSSP which uses B2B collaboration to provide services to our clients. We invite our MSSP accounts (eg. analyst@mssp.com) to every client tenant (client.com). Every time we onboard a new client or hire a new analyst, we need to process 40+ guest invitations. This is a massive pain point for us as it can only be done using the API or SDK, which means we either need to do this manually, or create our own script using the SDK.

We already use Bicep extensively in our onboardings, but due to this lack of functionality we cannot integrate our guest accounts into our onboarding deployments. Not being able to use Bicep for managing guest accounts adds complexity by requiring manual, error-prone scripting with the MS Graph SDK. It eliminates the benefits of automation, idempotency, and ease of scaling, which Bicep provides. This results in more maintenance overhead and inconsistent deployment processes, undermining efficiency and reliability.

Describe the solution you'd like

We need the ability to declaratively invite guest users in a Bicep file. The ideal use case is for us to have a parameter with an array of accounts to invite, and adding/removing an account from the array will invite/delete the account(s) as appropriate.

We already have the Microsoft.Graph/users type. I see two possible solutions for adding this funcitonality:

  1. Add a new resource type Microsoft.Graph/guestUsers which invites accounts from other tenants based on properties you give it
  2. Add functionality to the Microsoft.Graph/users type which supports inviting guest accounts (eg. a property to set which defines whether the user is a tenant user or a guest to invite)

Additional context
API reference for guest user invitations - Link
B2B accounts documentation - Link
Microsoft.Graph/users type - Link

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.