Super Admin
Get a Super Admin's Assigned Companies
GET https://api-b2b.bigcommerce.com/api/v2/sales-reps/{superAdminId}/companiesRequest
Returns the list of Companies that the Super Admin is assigned to.
Equivalent Storefront GraphQL API Query: superAdminCompanies
. For more information, see the GraphQL Playground.
Authentication
- Authorization in header in the format of Bearer {{token}}
Parameters
- superAdminId in path - integerrequiredThe unique numeric ID assigned to the Super Admin by B2B Edition. This ID does not match the BigCommerce customer account ID. To find the ID of a given Super Admin account, use the Server-to-Server Super Admin API.
- offset in query0 - integerNumber of results to skip before displaying the current page.
- limit in query with default of 10 - integerMaximum number of results to display per page. Values over
250
will return only250
results. - orderBy in query - stringDetermines the Company field by which results will be sorted. If this is omitted, results are sorted by
companyId
.Allowed: companyName | companyAdminName | companyEmail
- sortBy in query with default of DESC - stringDetermines the sort order (ascending or descending) of the results.
Allowed: DESC | ASC
- q in query - stringSearch string for filtering results. If this parameter is provided, results will include entries with a partial match in
companyName
orcompanyAdminEmail
. - companyId in query - stringSearch string for filtering results by
companyId
. Only returns data with an exact match incompanyId
. This ID does not match the ID shown in B2B Edition. To get a specific Company's ID, use the Server-to-Server Company API.
example
Response
Body
codeinteger
HTTP response code for the request.Default: 200
dataobject
Data associated with the response.paginationobject
example
Get a Super Admin's Current Masquerading Company
GET https://api-b2b.bigcommerce.com/api/v2/sales-reps/{superAdminId}/companies/masqueradingRequest
Returns basic details for the Company the Super Admin is currently masquerading as.
Equivalent Storefront GraphQL API Query: superAdminMasquerading
. For more information, see the GraphQL Playground.
Authentication
- Authorization in header in the format of Bearer {{token}}
Parameters
- superAdminId in path - integerrequiredThe unique numeric ID assigned to the Super Admin by B2B Edition. This ID does not match the BigCommerce customer account ID. To find the ID of a given Super Admin account, use the Server-to-Server Super Admin API.
example
Response
Body
codeinteger
HTTP response code for the request.Default: 200
dataobject
Data associated with the response.
example
Begin a Super Admin Masquerade
PUT https://api-b2b.bigcommerce.com/api/v2/sales-reps/{superAdminId}/companies/{companyId}/begin-masqRequest
Updates the status of the Super Admin associated with superAdminId
to masquerade as the Company associated with companyId
.
Equivalent Storefront GraphQL API Mutation: superAdminBeginMasquerade
. For more information, see the GraphQL Playground.
Authentication
- Authorization in header in the format of Bearer {{token}}
Parameters
- superAdminId in path - integerrequiredThe unique numeric ID assigned to the Super Admin by B2B Edition. This ID does not match the BigCommerce customer account ID. To find the ID of a given Super Admin account, use the Server-to-Server Super Admin API.
- companyId in path - integerrequiredThe unique numeric ID for a Company to which the Super Admin is assigned. To find a Company ID, use the Server-to-Server B2B Company API. For stores using Dependent Company behavior, this does not match the ID found in B2B Edition.
Response
Body
codeinteger
HTTP response code for the request.Default: 200
dataobject
Data associated with the response.
example
End a Super Admin Masquerade
PUT https://api-b2b.bigcommerce.com/api/v2/sales-reps/{superAdminId}/companies/{companyId}/end-masqRequest
Updates the status of the Super Admin associated with superAdminId
, ending their masquerade as the Company associated with companyId
.
Equivalent Storefront GraphQL API Mutation: superAdminEndMasquerade
. For more information, see the GraphQL Playground.
Authentication
- Authorization in header in the format of Bearer {{token}}
Parameters
- superAdminId in path - integerrequiredThe unique numeric ID assigned to the Super Admin by B2B Edition. This ID does not match the BigCommerce customer account ID. To find the ID of a given Super Admin account, use the Server-to-Server Super Admin API.
- companyId in path - integerrequiredThe unique numeric ID for a Company to which the Super Admin is assigned. To find a Company ID, use the Server-to-Server B2B Company API. For stores using Dependent Company behavior, this does not match the ID found in B2B Edition.
Response
Body
codeinteger
HTTP response code for the request.Default: 200
dataobject
Data associated with the response.