Trade Show
  1. Sales Reps
Trade Show
  • Introduction
  • Warehouses
    • Create a new Warehouse
      POST
    • Update a Warehouse
      PUT
    • Get a list of Warehouses
      GET
    • Retrieve a specific Warehouse by ID
      GET
    • Delete a Warehouse
      DELETE
  • Delivery Groups
    • Create a new Delivery Group
      POST
    • Update a Delivery Group
      PUT
    • Get a list of Delivery Groups
      GET
    • Retrieve a specific Delivery Group by ID
      GET
    • Delete a Delivery Group
      DELETE
  • Delivery Ranges
    • Create a new Delivery Range
      POST
    • Update a Delivery Range
      PUT
    • Get a list of Delivery Ranges
      GET
    • Retrieve a specific Delivery Range by ID
      GET
    • Delete a Delivery Range
      DELETE
  • Delivery Drops
    • Create a new Delivery Drop
      POST
    • Update a Delivery Drop
      PUT
    • Get a list of Delivery Drops
      GET
    • Retrieve a specific Delivery Drop by ID
      GET
    • Delete a Delivery Drop
      DELETE
  • Sales Rep Hierarchies
    • Define Hierarchy Levels
    • Create Sales Rep Group
    • Update Sales Rep Group
    • Move Sales Rep Group
    • Reorder Sales Rep Groups
    • Get a list of Sales Rep Groups
    • Get Sales Rep Group
    • Delete Sales Rep Group
  • Sales Reps
    • Create a new sales rep
      POST
    • Update a sales rep
      PUT
    • Get a list of sales reps
      GET
    • Retrieve a specific sales rep by ID
      GET
    • Delete a sales rep
      DELETE
  • Sales Rep Managers
    • Create a new sales rep manager
    • Update a sales rep manager
    • Get a list of sales rep managers
    • Retrieve a specific sales rep manager by ID
    • Delete a sales rep manager
  • Ordering Groups
    • Create a new Ordering Group
    • Update a Ordering Group
    • Get a list of Ordering Groups
    • Retrieve a specific Ordering Group by ID
    • Delete a Ordering Group
  • Customers
    • Create a new Customer Class
    • Get a list of Customer Classes
    • Retrieve a specific Customer Class by ID
    • Update a Customer Class
    • Delete a Customer Class
    • Create a new Customer
    • Get a list of Customers
    • Retrieve a specific Customer by ID
    • Update a Customer
    • Delete a Customer
  • Attendees
    • Create a new Attendee
    • Update a Attendee
    • Get a list of Attendees
    • Retrieve a specific Attendee by ID
    • Delete a Attendee
  • Vendors
    • Create a new Vendor
    • Update a Vendor
    • Get a list of Vendors
    • Retrieve a specific Vendor by ID
    • Delete a Vendor
    • Create a new vendor user
    • Update a vendor user
    • Get a list of vendor users
    • Retrieve a specific vendor user by ID
    • Delete a vendor user
  • Brokers
    • Create a new Broker
    • Update a Broker
    • Get a list of Brokers
    • Retrieve a specific Broker by ID
    • Delete a Broker
    • Create a new broker user
    • Update a broker user
    • Get a list of broker users
    • Retrieve a specific broker user by ID
    • Delete a broker user
  • Booths
    • Create a new Booth
    • Update a Booth
    • Get a list of Booths
    • Retrieve a specific Booth by ID
    • Delete a Booth
    • Associate a product to a booth
    • Get a list of products associated with a booth
    • Associate multiple products to a booth
    • Remove a product from a booth
    • Associate a vendor to a booth
    • Associate multiple vendors to a booth
    • Get a list of vendors associated with a booth
    • Remove a vendor from a booth
  • Facilitators
    • Create a new Facilitator
    • Update a Facilitator
    • Get a list of Facilitators
    • Retrieve a specific Facilitator by ID
    • Delete a Facilitator
  • Brands
    • Create a new Brand
    • Update a Brand
    • Get a list of Brands
    • Retrieve a specific Brand by ID
    • Delete a Brand
  • Categories
    • Create a new Category
    • Update a Category
    • Get a list of Categories
    • Retrieve a specific Category by ID
    • Delete a Category
  • Products
    • Create new pricing for a product
    • Update product pricing by price ID
    • Get a collection of price lists for products
    • Retrieve pricing by price ID
    • Delete a price list by ID
    • Create a new Product
    • Update a Product
    • Get a list of Products
    • Retrieve a specific Product by ID
    • Delete a Product
    • Get a list of Product Inventory
    • Bulk update product inventory
  • Orders
    • Bulk create orders
    • Bulk update orders
    • Get a list of orders
    • Retrieve a specific order by ID
    • Delete an order line
    • Get a list of order history buckets
    • Bulk create order history items
    • Get a list of order history items
  • Delivery Dates
    • Get a list of delivery dates
    • Retrieve delivery dates by product using ID
  • VIP Users
    • Create a new VIP user
    • Update a VIP user
    • Get a list of VIP users
    • Retrieve a specific VIP user by ID
    • Delete a VIP user
  • Show Admins
    • Create a new Show Admin
    • Update a Show Admin
    • Get a list of Show Admins
    • Retrieve a specific Show Admin by ID
    • Delete a Show Admin
  • Exports
    • Get available exports
    • Get parameter options
    • Run Custom Export
  1. Sales Reps

Create a new sales rep

POST
/SalesRep
Sales Reps
Create a new user for a sales representative. Sales reps are assigned to customers to assist with ordering, selling products on behalf of the distributor.
The following must be imported or configured before assigning:
salesRepGroup
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/SalesRep' \
--header 'Content-Type: application/json' \
--data-raw '{
    "userID": "USER4503",
    "salutation": "Ms",
    "firstName": "Retha",
    "initial": "C",
    "lastName": "Kautzer",
    "jobTitle": "Principal Interactions Developer",
    "phone": "(544) 956-9026",
    "fax": "(633) 448-8275",
    "scanID": "RDRJTN",
    "notificationEmail": "Andy.Stark8@hotmail.com",
    "bio": "dreamer",
    "active": false,
    "attendanceType": "Both",
    "salesRepGroupID": "4276",
    "externalID": "3013",
    "atShowNegotiator": true,
    "canChat": false,
    "canImpersonateAttendee": true,
    "canReceiveSMS": false,
    "arrivalNotificationBehavior": "All",
    "browseCustomerID": "6688"
}'
Response Response Example
200 - Created Sales Rep
{
    "id": "ts9232",
    "userID": "USER4503",
    "salutation": "Ms",
    "firstName": "Retha",
    "initial": "C",
    "lastName": "Kautzer",
    "jobTitle": "Principal Interactions Developer",
    "phone": "(544) 956-9026",
    "fax": "(633) 448-8275",
    "scanID": "RDRJTN",
    "notificationEmail": "Andy.Stark8@hotmail.com",
    "bio": "dreamer",
    "active": false,
    "attendanceType": "Both",
    "salesRepGroupID": "4276",
    "externalID": "3013",
    "atShowNegotiator": true,
    "canChat": false,
    "canImpersonateAttendee": true,
    "canReceiveSMS": false,
    "arrivalNotificationBehavior": "All",
    "browseCustomerID": "6688"
}

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Body Params application/json
userID
string 
optional
Used with a password to sign in
<= 100 characters
salutation
string 
optional
Select from existing salutations (Mr, Ms, Mrs, or Dr). Customizable salutations can be preloaded
firstName
string 
required
First Name
<= 50 characters
initial
string 
optional
Middle initial
<= 5 characters
lastName
string 
optional
Last Name
<= 50 characters
jobTitle
string 
optional
Select from preloaded job titles
phone
string 
optional
Phone number used to contact the sales rep
<= 30 characters
fax
string 
optional
Fax number used to send documents
<= 30 characters
scanID
string 
optional
Unique code used to sign in with a badge (or manually input). Autogenerated if not supplied
<= 100 characters
notificationEmail
string 
optional
Email where notifications will be sent
<= 100 characters
bio
string 
optional
Summary description of the user
active
boolean 
optional
Determines whether the user is actively associated with the show
attendanceType
enum<string> 
optional
Specifies presence of attendee. Both means that the attendee will be attending a physical show and allowed to order online.
Allowed values:
BothVirtual OnlyOnsite Only
Default:
Both
salesRepGroupID
string 
optional
Unique ID of the sales representative group
externalID
string 
optional
Unique ID provided to reference the sales rep
atShowNegotiator
boolean 
optional
Determines whether the user can negotiates allowances during a live show
canChat
boolean 
optional
Determines whether the user can chat with attendees on the Cloud Show website
canImpersonateAttendee
boolean 
optional
Determines whether a user can act on behalf of an attendee
canReceiveSMS
boolean 
optional
This attendee can be sent text messages via SMS
arrivalNotificationBehavior
enum<string> 
optional
How customers are notified when product arrives in stock
Allowed values:
OffBuyers OnlyAll
browseCustomerID
string 
optional
Customer ID used for browsing products
Examples

Responses

🟢200OK
application/json
Already Exists
Body
id
string 
read-onlyoptional
Unique ID specific to this API
modifiedDate
string <date-time>
read-onlyoptional
Last time this item was updated, only displayed when supplying the modifiedAfter parameter in a query
userID
string 
optional
Used with a password to sign in
<= 100 characters
salutation
string 
optional
Select from existing salutations (Mr, Ms, Mrs, or Dr). Customizable salutations can be preloaded
firstName
string 
required
First Name
<= 50 characters
initial
string 
optional
Middle initial
<= 5 characters
lastName
string 
optional
Last Name
<= 50 characters
jobTitle
string 
optional
Select from preloaded job titles
phone
string 
optional
Phone number used to contact the sales rep
<= 30 characters
fax
string 
optional
Fax number used to send documents
<= 30 characters
scanID
string 
optional
Unique code used to sign in with a badge (or manually input). Autogenerated if not supplied
<= 100 characters
notificationEmail
string 
optional
Email where notifications will be sent
<= 100 characters
bio
string 
optional
Summary description of the user
active
boolean 
optional
Determines whether the user is actively associated with the show
attendanceType
enum<string> 
optional
Specifies presence of attendee. Both means that the attendee will be attending a physical show and allowed to order online.
Allowed values:
BothVirtual OnlyOnsite Only
Default:
Both
salesRepGroupID
string 
optional
Unique ID of the sales representative group
externalID
string 
optional
Unique ID provided to reference the sales rep
atShowNegotiator
boolean 
optional
Determines whether the user can negotiates allowances during a live show
canChat
boolean 
optional
Determines whether the user can chat with attendees on the Cloud Show website
canImpersonateAttendee
boolean 
optional
Determines whether a user can act on behalf of an attendee
canReceiveSMS
boolean 
optional
This attendee can be sent text messages via SMS
arrivalNotificationBehavior
enum<string> 
optional
How customers are notified when product arrives in stock
Allowed values:
OffBuyers OnlyAll
browseCustomerID
string 
optional
Customer ID used for browsing products
🟢201Created
🟠400Bad Request
Modified at 2025-05-20 19:25:10
Previous
Delete Sales Rep Group
Next
Update a sales rep
Built with