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

[@salesforce/b2c-tooling-sdk](../modules.md) / instance

# instance

B2C Instance management.

This module provides the [B2CInstance](classes/B2CInstance.md) class which represents a connection
to a specific B2C Commerce instance. It combines instance configuration with
authentication to provide typed API clients.

## Usage

### From configuration (recommended)

Use resolveConfig to load configuration from dw.json and create an instance:

```typescript
import { resolveConfig } from '@salesforce/b2c-tooling-sdk/config';

const config = resolveConfig({
  clientId: process.env.SFCC_CLIENT_ID,
  clientSecret: process.env.SFCC_CLIENT_SECRET,
});

const instance = config.createB2CInstance();

// Use typed clients
await instance.webdav.put('Cartridges/v1/app.zip', content);
const { data } = await instance.ocapi.GET('/sites', {});
```

### Direct construction

```typescript
const instance = new B2CInstance(
  { hostname: 'your-sandbox.demandware.net', codeVersion: 'v1' },
  { oauth: { clientId: '...', clientSecret: '...' } }
);
```

## Classes

- [B2CInstance](classes/B2CInstance.md)

## Interfaces

- [InstanceConfig](interfaces/InstanceConfig.md)

## References

### AuthConfig

Re-exports [AuthConfig](../auth/interfaces/AuthConfig.md)

***

### TlsOptions

Re-exports [TlsOptions](../clients/interfaces/TlsOptions.md)