1. Buyers
Trade Show
V2
  • V2
  • V1
  • 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 Sales Rep Groups
    • Get Sales Rep Group
    • Delete Sales Rep Group
  • Sales Reps
    • Create a new sales rep
    • Update a sales rep
    • Get a list of sales reps
    • Retrieve a specific sales rep by ID
    • Delete a sales rep
  • Sales Rep Managers
    • Get a list of sales rep managers
    • Create a new sales rep manager
    • Retrieve a specific sales rep manager by ID
    • Update a sales rep manager
    • 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
    • BULK: Create and update Customers
    • 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
    • BULK: Create and update Vendors
    • 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
    • Get a list of Brokers
    • Create a new Broker
    • Retrieve a specific Broker by ID
    • Update a Broker
    • Delete a Broker
    • Get a list of broker users
    • Create a new broker user
    • Retrieve a specific broker user by ID
    • Update a broker user
    • Delete a broker user
  • Buyers
    • Get a list of Buyers
      GET
    • Retrieve a specific Buyer by ID
      GET
    • Create a new Buyer
      POST
    • Update a Buyer
      PUT
    • Delete a Buyer
      DELETE
  • 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
    • Choose which products are associated to a booth using a list of product IDs
    • Get a list of products associated with a booth
    • Remove a product from a booth
    • Associate a vendor to a booth
    • Choose which vendors are associated to a booth using a list of vendor IDs
    • 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
  • Departments
    • Get a list of Departments
    • Retrieve a specific Department by ID
    • Create a new Department
    • Update a Department
    • Delete a Department
  • Products
    • Get a collection of price lists for products
    • BULK: Create and Update Pricing
    • Retrieve pricing by price ID
    • Update product pricing by price ID
    • Delete a price list by ID
    • Get a list of Products
    • Create a new Product
    • BULK: Create and update Products
    • Retrieve a specific Product by ID
    • Update a Product
    • Delete a Product
    • Return a collection of prices for the selected product.
    • Create new pricing for 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
  • Schemas
    • Schemas
      • DeleteResponse
      • SalesRepLevel
      • UpdateInventory
      • ProductInventory
      • OrderHistory
      • registrationStatus
      • ValidationProblemDetails
      • attendanceType
      • arrivalNotificationBehavior
      • UserList
      • VendorUser
      • VIP
      • ShowAdmin
      • SalesRepManager
      • SalesRep
      • Facilitator
      • BrokerUser
      • User
      • UserInput
      • PaginationSchema
      • UpdateOrder
      • CreateOrder
      • OrderHistoryItem
      • OrderHistoryBucket
      • Attendee
      • OrderingGroup V1
      • Booth
      • CreateOrderLine
      • Brand
      • UpdateOrderLine
      • OrderResult
      • OrderLineError
      • OrderHistoryResult
      • IdMessage
      • Broker
      • Category
      • Customer
      • CustomerClass
      • DeliveryDrop
      • DeliveryGroup
      • DeliveryRange
      • Export
      • ExportParameter
      • OrderingGroup
      • OrderingSubGroup
      • Pricing
      • ProductPricing
      • Product
      • SalesRepGroup
      • Vendor
      • Warehouse
      • OrderLine
      • PurchaseOrder
      • OrderAllowance
      • BulkCustomerResponse
      • BulkVendorResponse
      • BulkProductResponse
      • BulkPricingResponse
      • BadRequest
      • Buyer
      • Department
  1. Buyers

Create a new Buyer

POST
/v2/buyers/create
Create a new buyer. Buyers are responsible for managing the prices and products available at the show, and are assigned to products by their userID.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Body Params application/jsonRequired

Examples

Responses

🟢200OK
application/json
Already Exists
Bodyapplication/json

🟢201Created
🟠400Bad Request
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://tsapi.perenso.net/v2/buyers/create' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "userID": "[email protected]",
    "salutation": "Mr",
    "firstName": "Jordan",
    "lastName": "Lee",
    "jobTitle": "Category Buyer",
    "phone": "(555) 010-2030",
    "notificationEmail": "[email protected]",
    "active": true,
    "isAttending": true,
    "attendanceType": "Onsite Only",
    "street1": "1 Main Street",
    "city": "Denver",
    "state": "COLORADO",
    "zipCode": "80202"
}'
Response Response Example
200 - Buyer
{
    "id": "k3m9qz",
    "userID": "[email protected]",
    "firstName": "Jordan",
    "scanID": "Q8ZK3T",
    "active": false,
    "canImpersonateAttendee": false,
    "isAttending": false,
    "attendanceType": "Both",
    "registrationStatus": "Not Registered"
}
Modified at 2026-10-16 13:14:43
Previous
Retrieve a specific Buyer by ID
Next
Update a Buyer
Built with