Sales Staff
Sales Staff are backend team members who have access to a set group of Companies and features within B2B Edition. By default, Sales Staff will have the system user role Sales Rep, but you can create custom system user roles within B2B Edition that function as Sales Staff. For more information on configuring system user roles, see B2B Edition User Roles and Permissions (Help Center) (opens in a new tab).
Note: These endpoints are specifically for managing the Company assignments of backend user accounts. To manage frontend user accounts, see User (Server-to-Server) for individual accounts or Company (Server-to-Server) for Company accounts.
Get All Sales Staff
GET https://api-b2b.bigcommerce.com/api/v3/io/sales-staffsRequest
Authentication
- authToken in header
Parameters
- limit in query with default of 10 - integerMaximum number of results to display per page.
- offset in query0 - integerNumber of results to skip before displaying the current page.
- orderBy in query with default of DESC - stringSort direction of results, ascending or descending, applied to the
sortBy
parameter.Allowed: DESC | ASC
- companyId in query - stringUnique numeric ID of the Company account.
- minModified in query - integerThe earliest Unix timestamp that can be returned for a modified Company account.
- sortBy in query with default of updated_at - stringField by which data should be sorted in the response.
Allowed: updated_at | email
example
Response
Body
codeinteger
HTTP response code for the request.Default: 200
dataarray[object]
Data array associated with the response.
example
Get Sales Staff Account Details
GET https://api-b2b.bigcommerce.com/api/v3/io/sales-staffs/{salesStaffId}Request
salesStaffId
, including an array of Companies to which the account is assigned and when the assignment was made.Authentication
- authToken in header
Parameters
- salesStaffId in path - integerrequiredUnique numeric ID of the Sales Staff account.
example
Response
Body
codeinteger
HTTP response code for the request.Default: 200
dataobject
Data associated with the response.
example
Update Sales Staff Assignments
PUT https://api-b2b.bigcommerce.com/api/v3/io/sales-staffs/{salesStaffId}Request
salesStaffId
. This operation is non-destructive, meaning that assigning or unassigning a single Company from the Sales Staff does not affect the other assignments.Authentication
- authToken in header
Parameters
- salesStaffId in path - integerrequiredUnique numeric ID of the Sales Staff account.
Body
companyIdinteger
requiredUnique numeric ID of the Company account.Example: 123456assignStatusboolean
requiredIndicates whether the Sales Staff account is being assigned to (true
) or unassigned from (false
) the Company.
example
Response
Body
codeinteger
HTTP response code for the request.Default: 200
dataobject
Data associated with the response.
example
See something you can improve? Edit this file on GitHub