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

[@salesforce/b2c-tooling-sdk](../../modules.md) / [clients](../index.md) / AccountManagerClient

# Interface: AccountManagerClient

Defined in: [packages/b2c-tooling-sdk/src/clients/am-api.ts:1308](https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/blob/1cc5681b8c76554833dc7a40097f33641882a372/packages/b2c-tooling-sdk/src/clients/am-api.ts#L1308)

Unified Account Manager API client that combines users, roles, and organizations.

This client provides direct access to all Account Manager API methods through
a single interface, while internally using separate typed clients for type safety.

## Methods

### changeApiClientPassword()

> **changeApiClientPassword**(`apiClientId`, `oldPassword`, `newPassword`): `Promise`\<`void`\>

Defined in: [packages/b2c-tooling-sdk/src/clients/am-api.ts:1353](https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/blob/1cc5681b8c76554833dc7a40097f33641882a372/packages/b2c-tooling-sdk/src/clients/am-api.ts#L1353)

Change an API client password

#### Parameters

##### apiClientId

`string`

##### oldPassword

`string`

##### newPassword

`string`

#### Returns

`Promise`\<`void`\>

***

### createApiClient()

> **createApiClient**(`body`): `Promise`\<\{ \}\>

Defined in: [packages/b2c-tooling-sdk/src/clients/am-api.ts:1347](https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/blob/1cc5681b8c76554833dc7a40097f33641882a372/packages/b2c-tooling-sdk/src/clients/am-api.ts#L1347)

Create a new API client

#### Parameters

##### body

#### Returns

`Promise`\<\{ \}\>

***

### createUser()

> **createUser**(`user`): `Promise`\<\{ \}\>

Defined in: [packages/b2c-tooling-sdk/src/clients/am-api.ts:1315](https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/blob/1cc5681b8c76554833dc7a40097f33641882a372/packages/b2c-tooling-sdk/src/clients/am-api.ts#L1315)

Create a new user

#### Parameters

##### user

#### Returns

`Promise`\<\{ \}\>

***

### deleteApiClient()

> **deleteApiClient**(`apiClientId`): `Promise`\<`void`\>

Defined in: [packages/b2c-tooling-sdk/src/clients/am-api.ts:1351](https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/blob/1cc5681b8c76554833dc7a40097f33641882a372/packages/b2c-tooling-sdk/src/clients/am-api.ts#L1351)

Delete an API client (must be disabled 7+ days)

#### Parameters

##### apiClientId

`string`

#### Returns

`Promise`\<`void`\>

***

### deleteUser()

> **deleteUser**(`userId`): `Promise`\<`void`\>

Defined in: [packages/b2c-tooling-sdk/src/clients/am-api.ts:1319](https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/blob/1cc5681b8c76554833dc7a40097f33641882a372/packages/b2c-tooling-sdk/src/clients/am-api.ts#L1319)

Disable a user (soft delete)

#### Parameters

##### userId

`string`

#### Returns

`Promise`\<`void`\>

***

### findUserByLogin()

> **findUserByLogin**(`login`, `expand?`): `Promise`\<\{ \} \| `undefined`\>

Defined in: [packages/b2c-tooling-sdk/src/clients/am-api.ts:1325](https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/blob/1cc5681b8c76554833dc7a40097f33641882a372/packages/b2c-tooling-sdk/src/clients/am-api.ts#L1325)

Find a user by login (email)

#### Parameters

##### login

`string`

##### expand?

(`"roles"` \| `"organizations"`)[]

#### Returns

`Promise`\<\{ \} \| `undefined`\>

***

### getApiClient()

> **getApiClient**(`apiClientId`, `expand?`): `Promise`\<\{ \}\>

Defined in: [packages/b2c-tooling-sdk/src/clients/am-api.ts:1345](https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/blob/1cc5681b8c76554833dc7a40097f33641882a372/packages/b2c-tooling-sdk/src/clients/am-api.ts#L1345)

Get API client by ID

#### Parameters

##### apiClientId

`string`

##### expand?

(`"roles"` \| `"organizations"`)[]

#### Returns

`Promise`\<\{ \}\>

***

### getOrg()

> **getOrg**(`orgId`): `Promise`\<[`AccountManagerOrganization`](AccountManagerOrganization.md)\>

Defined in: [packages/b2c-tooling-sdk/src/clients/am-api.ts:1357](https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/blob/1cc5681b8c76554833dc7a40097f33641882a372/packages/b2c-tooling-sdk/src/clients/am-api.ts#L1357)

Get organization by ID

#### Parameters

##### orgId

`string`

#### Returns

`Promise`\<[`AccountManagerOrganization`](AccountManagerOrganization.md)\>

***

### getOrgByName()

> **getOrgByName**(`name`): `Promise`\<[`AccountManagerOrganization`](AccountManagerOrganization.md)\>

Defined in: [packages/b2c-tooling-sdk/src/clients/am-api.ts:1359](https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/blob/1cc5681b8c76554833dc7a40097f33641882a372/packages/b2c-tooling-sdk/src/clients/am-api.ts#L1359)

Get organization by name

#### Parameters

##### name

`string`

#### Returns

`Promise`\<[`AccountManagerOrganization`](AccountManagerOrganization.md)\>

***

### getOrgMapping()

> **getOrgMapping**(): `Promise`\<[`OrgMapping`](OrgMapping.md)\>

Defined in: [packages/b2c-tooling-sdk/src/clients/am-api.ts:1339](https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/blob/1cc5681b8c76554833dc7a40097f33641882a372/packages/b2c-tooling-sdk/src/clients/am-api.ts#L1339)

Get the org mapping (id → name), lazily cached

#### Returns

`Promise`\<[`OrgMapping`](OrgMapping.md)\>

***

### getRole()

> **getRole**(`roleId`): `Promise`\<\{ \}\>

Defined in: [packages/b2c-tooling-sdk/src/clients/am-api.ts:1333](https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/blob/1cc5681b8c76554833dc7a40097f33641882a372/packages/b2c-tooling-sdk/src/clients/am-api.ts#L1333)

Get role by ID

#### Parameters

##### roleId

`string`

#### Returns

`Promise`\<\{ \}\>

***

### getRoleMapping()

> **getRoleMapping**(): `Promise`\<[`RoleMapping`](RoleMapping.md)\>

Defined in: [packages/b2c-tooling-sdk/src/clients/am-api.ts:1337](https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/blob/1cc5681b8c76554833dc7a40097f33641882a372/packages/b2c-tooling-sdk/src/clients/am-api.ts#L1337)

Get the role mapping (id ↔ roleEnumName), lazily cached

#### Returns

`Promise`\<[`RoleMapping`](RoleMapping.md)\>

***

### getUser()

> **getUser**(`userId`, `expand?`): `Promise`\<\{ \}\>

Defined in: [packages/b2c-tooling-sdk/src/clients/am-api.ts:1311](https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/blob/1cc5681b8c76554833dc7a40097f33641882a372/packages/b2c-tooling-sdk/src/clients/am-api.ts#L1311)

Get user by ID

#### Parameters

##### userId

`string`

##### expand?

(`"roles"` \| `"organizations"`)[]

#### Returns

`Promise`\<\{ \}\>

***

### grantRole()

> **grantRole**(`userId`, `role`, `scope?`): `Promise`\<\{ \}\>

Defined in: [packages/b2c-tooling-sdk/src/clients/am-api.ts:1327](https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/blob/1cc5681b8c76554833dc7a40097f33641882a372/packages/b2c-tooling-sdk/src/clients/am-api.ts#L1327)

Grant a role to a user, optionally with scope

#### Parameters

##### userId

`string`

##### role

`string`

##### scope?

`string`

#### Returns

`Promise`\<\{ \}\>

***

### listApiClients()

> **listApiClients**(`options?`): `Promise`\<\{ \}\>

Defined in: [packages/b2c-tooling-sdk/src/clients/am-api.ts:1343](https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/blob/1cc5681b8c76554833dc7a40097f33641882a372/packages/b2c-tooling-sdk/src/clients/am-api.ts#L1343)

List API clients with pagination

#### Parameters

##### options?

[`ListApiClientsOptions`](ListApiClientsOptions.md)

#### Returns

`Promise`\<\{ \}\>

***

### listOrgs()

> **listOrgs**(`options?`): `Promise`\<[`OrganizationCollection`](OrganizationCollection.md)\>

Defined in: [packages/b2c-tooling-sdk/src/clients/am-api.ts:1361](https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/blob/1cc5681b8c76554833dc7a40097f33641882a372/packages/b2c-tooling-sdk/src/clients/am-api.ts#L1361)

List organizations with pagination

#### Parameters

##### options?

[`ListOrgsOptions`](ListOrgsOptions.md)

#### Returns

`Promise`\<[`OrganizationCollection`](OrganizationCollection.md)\>

***

### listRoles()

> **listRoles**(`options?`): `Promise`\<\{ \}\>

Defined in: [packages/b2c-tooling-sdk/src/clients/am-api.ts:1335](https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/blob/1cc5681b8c76554833dc7a40097f33641882a372/packages/b2c-tooling-sdk/src/clients/am-api.ts#L1335)

List roles with pagination

#### Parameters

##### options?

[`ListRolesOptions`](ListRolesOptions.md)

#### Returns

`Promise`\<\{ \}\>

***

### listUsers()

> **listUsers**(`options?`): `Promise`\<\{ \}\>

Defined in: [packages/b2c-tooling-sdk/src/clients/am-api.ts:1313](https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/blob/1cc5681b8c76554833dc7a40097f33641882a372/packages/b2c-tooling-sdk/src/clients/am-api.ts#L1313)

List users with pagination

#### Parameters

##### options?

[`ListUsersOptions`](ListUsersOptions.md)

#### Returns

`Promise`\<\{ \}\>

***

### purgeUser()

> **purgeUser**(`userId`): `Promise`\<`void`\>

Defined in: [packages/b2c-tooling-sdk/src/clients/am-api.ts:1321](https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/blob/1cc5681b8c76554833dc7a40097f33641882a372/packages/b2c-tooling-sdk/src/clients/am-api.ts#L1321)

Purge a user (hard delete)

#### Parameters

##### userId

`string`

#### Returns

`Promise`\<`void`\>

***

### resetUser()

> **resetUser**(`userId`): `Promise`\<`void`\>

Defined in: [packages/b2c-tooling-sdk/src/clients/am-api.ts:1323](https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/blob/1cc5681b8c76554833dc7a40097f33641882a372/packages/b2c-tooling-sdk/src/clients/am-api.ts#L1323)

Reset a user to INITIAL state

#### Parameters

##### userId

`string`

#### Returns

`Promise`\<`void`\>

***

### revokeRole()

> **revokeRole**(`userId`, `role`, `scope?`): `Promise`\<\{ \}\>

Defined in: [packages/b2c-tooling-sdk/src/clients/am-api.ts:1329](https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/blob/1cc5681b8c76554833dc7a40097f33641882a372/packages/b2c-tooling-sdk/src/clients/am-api.ts#L1329)

Revoke a role from a user, optionally removing specific scope

#### Parameters

##### userId

`string`

##### role

`string`

##### scope?

`string`

#### Returns

`Promise`\<\{ \}\>

***

### updateApiClient()

> **updateApiClient**(`apiClientId`, `body`): `Promise`\<\{ \}\>

Defined in: [packages/b2c-tooling-sdk/src/clients/am-api.ts:1349](https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/blob/1cc5681b8c76554833dc7a40097f33641882a372/packages/b2c-tooling-sdk/src/clients/am-api.ts#L1349)

Update an existing API client

#### Parameters

##### apiClientId

`string`

##### body

#### Returns

`Promise`\<\{ \}\>

***

### updateUser()

> **updateUser**(`userId`, `changes`): `Promise`\<\{ \}\>

Defined in: [packages/b2c-tooling-sdk/src/clients/am-api.ts:1317](https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/blob/1cc5681b8c76554833dc7a40097f33641882a372/packages/b2c-tooling-sdk/src/clients/am-api.ts#L1317)

Update an existing user

#### Parameters

##### userId

`string`

##### changes

#### Returns

`Promise`\<\{ \}\>