Update Super Admin Details | BigCommerce Developer Center

Updates the account information of the Super Admin associated with superAdminId.

NOTE
A BigCommerce customer account and a B2B Edition user account are both uniquely identified by their email address. As such, the email field is considered read-only. Updating the email address should be avoided, but may be done with the Update Customers endpoint.

Updates the account information of the Super Admin associated with `superAdminId`. > **NOTE** > A BigCommerce customer account and a B2B Edition user account are both uniquely identified by their email address. As such, the `email` field is considered read-only. Updating the email address should be avoided, but may be done with the [Update Customers](/developer/api-reference/rest/admin/management/customers/v3#update-customers) endpoint.

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-accounts). | ### Further reading For example requests and more information about authenticating BigCommerce APIs, see [Authentication and Example Requests](/developer/docs/overview/api-accounts#x-auth-token-header-example-requests). For more about BigCommerce OAuth scopes, see our [Guide to API Accounts](/developer/docs/overview/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. |

Path parameters

superAdminIdstringRequired

Request

This endpoint expects an object.

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.

extraFieldslist of objectsOptional

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.

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

404

Not Found Error

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

1	{
2	"data": {
3	"channelList": [
4	{
5	"channelId": 1,
6	"channelName": "Great Buys Wholesale",
7	"iconUrl": "https://s3.amazonaws.com/bc-channel-platform/channel-icons/bigcommerce.svg"
8	}
9	],
10	"createdAt": 1745868780,
11	"email": "marie.curie@example.com",
12	"extraFields": [
13	{
14	"fieldName": "customField1",
15	"fieldValue": "foo"
16	}
17	],
18	"firstName": "Marie",
19	"id": 123456,
20	"lastName": "Curie",
21	"phone": "string",
22	"updatedAt": 1750962754,
23	"uuid": "string"
24	},
25	"meta": {}
26	}