Trade Show
V2
  • V2
  • V1
  1. Vendors
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
    • Update a Delivery Drop
    • Get a list of Delivery Drops
    • Retrieve a specific Delivery Drop by ID
    • Delete a Delivery Drop
  • 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
    • 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
    • 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
      POST
    • BULK: Create and update Vendors
      POST
    • Update a Vendor
      PUT
    • Get a list of Vendors
      GET
    • Retrieve a specific Vendor by ID
      GET
    • Delete a Vendor
      DELETE
    • Create a new vendor user
      POST
    • Update a vendor user
      PUT
    • Get a list of vendor users
      GET
    • Retrieve a specific vendor user by ID
      GET
    • Delete a vendor user
      DELETE
  • 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
    • 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
  • Products
    • Create new pricing for a product
    • BULK: Create and Update Pricing
    • Update product pricing by price ID
    • Get a collection of price lists for products
    • Retrieve pricing by price ID
    • Return a collection of prices for the selected product.
    • Delete a price list by ID
    • Create a new Product
    • BULK: Create and update Products
    • 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. Vendors

BULK: Create and update Vendors

POST
/v2/vendors/bulk
You can update or create Vendors in bulk by using this endpoint. If a vendorID is null we will attempt to create the new vendor. Provide a vendorID and we will attempt to update it.

Request

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

Examples

Responses

🟢200OK
application/json
Already Exists
Body

🟠400Bad Request
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://tsapi.perenso.net/v2/vendors/bulk' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "street1": "2616 Ernie Springs",
        "street2": "40257 S Broadway",
        "city": "McKenziechester",
        "state": "South Dakota",
        "zipCode": "02868-6895",
        "vendorID": "VEND6657",
        "vendorName": "Caleb Carter-Harber",
        "phone": "(608) 556-3751",
        "fax": "(678) 508-4385 x26526",
        "emailAddress": "[email protected]",
        "deliveryGroup": "8772",
        "brokers": [
            "BROKER2564",
            "BROKER3992",
            "BROKER0028"
        ],
        "active": true,
        "canNegotiateAtShow": false,
        "testVendor": false,
        "allottedUserCount": 16,
        "booths": [
            "BOOTH1541"
        ]
    }
]'
Response Response Example
200 - Bulk Response
{
    "successful": [
        {
            "id": "fk8ph2",
            "vendorID": "VEND0341"
        },
        {
            "id": "hsha8k",
            "vendorID": "VEND9722"
        }
    ],
    "failed": [
        {
            "vendorID": "VEND3102",
            "message": "error message"
        },
        {
            "vendorID": "VEND7859",
            "message": "error message"
        },
        {
            "vendorID": "VEND2006",
            "message": "error message"
        }
    ]
}
Modified at 2025-10-08 19:23:18
Previous
Create a new Vendor
Next
Update a Vendor
Built with