BigCommerce Docs

Create up to 10 Company users at once.

With (Independent Company behavior)[/developer/api-reference/rest/b2b/management/company/companies#independent-vs-dependent-companies-behavior] enabled, B2B Edition Company accounts are the source of truth for defining a Company user’s customer group assignment. If no default customer group is configured or the set value of customerGroupId is 0, the B2B Company will not be associated with any customer group. The Company users will have their corresponding customer records assigned to No Group in BigCommerce.

Create up to 10 Company users at once. With (Independent Company behavior)[/developer/api-reference/rest/b2b/management/company/companies#independent-vs-dependent-companies-behavior] enabled, B2B Edition Company accounts are the source of truth for defining a Company user’s customer group assignment. If no default customer group is configured or the set value of `customerGroupId` is 0, the B2B Company will not be associated with any customer group. The Company users will have their corresponding customer records assigned to No Group in BigCommerce.

Authentication

X-Auth-Tokenstring

Authentication header

Header	Argument	Description
`X-Auth-Token`	`access_token`	For more about API accounts that generate `access_token`s, see our Guide to API Accounts.

### Authentication header | Header | Argument | Description | |:-------|:---------|:------------| | `X-Auth-Token` | `access_token` | For more about API accounts that generate `access_token`s, see our [Guide to API Accounts](/developer/docs/overview/api-fundamentals/api-accounts). | ### Further reading For example requests and more information about authenticating BigCommerce APIs, see [Authentication and Example Requests](/developer/docs/overview/api-fundamentals/api-accounts#x-auth-token-header-example-requests). For more about BigCommerce OAuth scopes, see our [Guide to API Accounts](/developer/docs/overview/api-fundamentals/api-accounts#oauth-scopes). For a list of API status codes, see [API Status Codes](/developer/api-reference/rest/overview#rest-http-status-codes).

X-Store-Hashstring

Authentication header

Header	Argument	Description
`X-Store-Hash`	`store_hash`	The unique store hash associated with a BigCommerce store that has B2B Edition enabled.

### Authentication header | Header | Argument | Description | |:-------|:---------|:------------| | `X-Store-Hash` | `store_hash` | The unique store hash associated with a BigCommerce store that has B2B Edition enabled. |

Request

This endpoint expects a list of objects.

companyIdintegerRequired

The unique numeric ID associated with the user's B2B Edition Company account.

channelIdslist of integersRequired

List of numeric channel IDs the user is associated with. These represent the storefront channels the user can log in to and do business.

acceptWelcomeEmailbooleanOptional

Indicates whether the user will receive a welcome email when the account is created.

originChannelIdintegerOptional

The ID of the originating channel. A value of 0 will unset the user’s origin channel, which may result in unexpected behavior. To avoid errors, ensure all necessary channels are included in channelIds.

Response

Creation successful

codeintegerDefaults to 200

Operation status code.

datalist of objects

metaobject

Errors

413

Content Too Large Error

422

Unprocessable Entity Error

1	curl -X POST https://api-b2b.bigcommerce.com/api/v3/io/users/bulk \
2	-H "X-Auth-Token: <apiKey>" \
3	-H "Content-Type: application/json" \
4	-d '[
5	{
6	"channelIds": [
7	101,
8	102
9	]
10	},
11	{
12	"channelIds": [
13	103
14	]
15	}
16	]'

1	{
2	"code": null,
3	"data": null,
4	"meta": {
5	"message": null
6	}
7	}