Trade Show
V2
  • V2
  • V1
  1. Customers
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
      POST
    • Get a list of Customer Classes
      GET
    • Retrieve a specific Customer Class by ID
      GET
    • Update a Customer Class
      PUT
    • Delete a Customer Class
      DELETE
    • Create a new Customer
      POST
    • BULK: Create and update Customers
      POST
    • Get a list of Customers
      GET
    • Retrieve a specific Customer by ID
      GET
    • Update a Customer
      PUT
    • Delete a Customer
      DELETE
  • 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
    • 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. Customers

BULK: Create and update Customers

POST
/v2/customers/bulk
You can update or create Customers in bulk by using this endpoint. If the customerID matches an existing customer, it will be updated. Otherwise, it will be created.

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/customers/bulk' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "customerID": "string",
        "customerName": "string",
        "email": "string",
        "phone": "string",
        "fax": "string",
        "priceZone": 0,
        "test": true,
        "placeholder": true,
        "street1": "string",
        "street2": "string",
        "city": "string",
        "state": "string",
        "zipCode": "string",
        "allowanceGroup": "string",
        "deliveryGroup": "string",
        "warehouseID": "string",
        "customerClassID": "string",
        "orderPermissionKey": 0,
        "primarySalesRep": "string",
        "salesReps": [
            "string"
        ],
        "orderingGroups": [
            {
                "orderingGroupID": "string",
                "orderingGroupName": "string",
                "orderingSubGroups": [
                    {
                        "orderingGroupID": "string",
                        "orderingGroupName": "string",
                        "customers": [
                            "string"
                        ]
                    }
                ]
            }
        ],
        "extra1": "string",
        "extra2": "string",
        "extra3": "string",
        "extra4": "string",
        "extra5": "string"
    }
]'
Response Response Example
200 - Bulk Response
{
    "successful": [
        {
            "id": "9gsaja",
            "customerID": "CUST0719"
        },
        {
            "id": "86dk2g",
            "customerID": "CUST8849"
        },
        {
            "id": "shf869",
            "customerID": "CUST5004"
        }
    ],
    "failed": [
        {
            "customerID": "CUST2145",
            "messages": [
                "Error message"
            ]
        },
        {
            "customerID": "CUST3201",
            "messages": [
                "Error message"
            ]
        }
    ]
}
Modified at 2025-10-08 19:08:46
Previous
Create a new Customer
Next
Get a list of Customers
Built with