Create Super Admins (batch)

Creates new Super Admin users and assign them to BigCommerce channels as provided in the request body. Existing BigCommerce customer accounts will be converted to B2B Edition Super Admin accounts.

In normal conditions, this endpoint supports creation of no more than 10 Super Admins in a single request.

NOTE
If there is already a B2B Edition Company user account associated with an email address provided, this endpoint will return with errors, regardless of the role assigned to the B2B Edition Company user account. Existing BigCommerce customer accounts will not throw errors as long as they are not also B2B Edition Company user accounts.

If a user account for a given email doesn’t currently exist within BigCommerce, it will be created when the request is called.

Creates new Super Admin users and assign them to BigCommerce channels as provided in the request body. Existing BigCommerce customer accounts will be converted to B2B Edition Super Admin accounts. In normal conditions, this endpoint supports creation of no more than `10` Super Admins in a single request. > **NOTE** > If there is already a B2B Edition Company user account associated with an email address provided, this endpoint will return with errors, regardless of the role assigned to the B2B Edition Company user account. Existing BigCommerce customer accounts will not throw errors as long as they are not also B2B Edition Company user accounts. If a user account for a given `email` doesn't currently exist within BigCommerce, it will be created when the request is called.

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-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.

channelIdslist of integersOptional

An array of unique channel IDs associated with BigCommerce sales channels. The account will only be able to login on channels in this list.

emailstringOptionalformat: "email"

The email address associated with the Super Admin's BigCommerce customer account.

firstNamestringOptional

The first name listed on the Super Admin's BigCommerce customer account.

lastNamestringOptional

The last name listed on the Super Admin's BigCommerce customer account.

originChannelIdintegerOptional

The unique BigCommerce channel ID, used for the BigCommerce customer account's origin channel. This field is inactive if the store has a default B2B Edition channel set.

phonestringOptional

The phone number listed on the Super Admin's BigCommerce customer account.

uuidstringOptionalformat: "uuid"

An external ID associated with the Super Admin account. B2B Edition does not require UUID to be unique, despite the field’s label. B2B Edition will not assign a UUID by default.

NOTE
Some endpoints will only return this field if it has a non-empty value. If your code relies on the presence of a UUID in responses, ensure it is defined for each user, and prefer endpoints that provide more details.

Regardless of individual user status, make sure to check for existence before attempting to use the value of the uuid field.

An external ID associated with the Super Admin account. B2B Edition does not require UUID to be unique, despite the field's label. B2B Edition will not assign a UUID by default. > NOTE > Some endpoints will only return this field if it has a non-empty value. If your code relies on the presence of a UUID in responses, ensure it is defined for each user, and prefer endpoints that provide more details. > > Regardless of individual user status, make sure to check for existence before attempting to use the value of the `uuid` field.

Response

SUCCESS

codeintegerDefaults to 200

dataobject

metaobject

Errors

400

Bad Request Error

413

Content Too Large Error

422

Unprocessable Entity Error

Creates new Super Admin users and assign them to BigCommerce channels as provided in the request body. Existing BigCommerce customer accounts will be converted to B2B Edition Super Admin accounts.

In normal conditions, this endpoint supports creation of no more than 10 Super Admins in a single request.

NOTE
If there is already a B2B Edition Company user account associated with an email address provided, this endpoint will return with errors, regardless of the role assigned to the B2B Edition Company user account. Existing BigCommerce customer accounts will not throw errors as long as they are not also B2B Edition Company user accounts.

If a user account for a given email doesn’t currently exist within BigCommerce, it will be created when the request is called.

1	import requests
2
3	url = "https://api-b2b.bigcommerce.com/api/v3/io/super-admins/bulk"
4
5	payload = [{}]
6	headers = {
7	"X-Auth-Token": "<apiKey>",
8	"Content-Type": "application/json"
9	}
10
11	response = requests.post(url, json=payload, headers=headers)
12
13	print(response.json())

1	{
2	"data": {
3	"superAdminIds": [
4	123456
5	]
6	},
7	"meta": {}
8	}

Authentication

Authentication header

Further reading

Authentication header

Request

Response

Errors

Authentication header

Further reading

Authentication header