---
editLink: false
lastUpdated: false
---

[@salesforce/b2c-tooling-sdk](../../../modules.md) / [operations/bm-roles](../index.md) / grantBmRole

# Function: grantBmRole()

> **grantBmRole**(`instance`, `roleId`, `login`): `Promise`\<\{ \}\>

Defined in: [packages/b2c-tooling-sdk/src/operations/bm-roles/roles.ts:175](https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/blob/e7c16f1ae423da0aa47b3e10be88f9770b53619b/packages/b2c-tooling-sdk/src/operations/bm-roles/roles.ts#L175)

Assigns a user to an access role on an instance.

## Parameters

### instance

[`B2CInstance`](../../../instance/classes/B2CInstance.md)

B2C instance

### roleId

`string`

Role ID to grant

### login

`string`

User login (email)

## Returns

`Promise`\<\{ \}\>

The user object after assignment

## Example

```typescript
const user = await grantBmRole(instance, 'Administrator', 'user@example.com');
```