Clover API updates - April 2026
We made the following API updates for April 2026.
Platform API
Inventory API
Added low stock alert to item stock
To help retail merchants quickly assess when stock is running low for items that sell well, we updated the Inventory API to support low stock alerts. You can allow merchants to configure an alert threshold value that generates a notification when the item stock count falls below the configured amount.
We added the stockAlertThreshold field to the itemStock object. You can also expand the itemStock object and filter for lowStock=true when retrieving items.
Note: The stockAlertThresholdparameter is currently available only in North America (US and Canada).
Affected endpoints:
- Create item stock
- Update the stock of an inventory item
- Get the stock of an inventory item
- Get all inventory items
All APIs
Added User-Agent header requirement
To enhance security and maintain compliance across the Clover platform, you must now include a User-Agent header in all HTTP API requests. This requirement applies globally to all Clover API solutions, including Ecommerce, Platform, and REST Pay.
The User-Agent header helps identify the client application or service making the request. Update your existing integrations and include this header in all new requests to ensure they process successfully.
Header format
Set the User-Agent header using the following standard format:
User-Agent: <product> / <product-version> <comment>
Example request
The following curl example demonstrates how to include the User-Agent header in an order request:
curl --request POST \
--url 'https://sandbox.dev.clover.com/v3/merchants/{mId}/atomic_order/orders' \
--header 'User-Agent: PostmanRuntime/7.44.1' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {access_token}' \
--data '{
"orderCart": {
"currency": "USD",
"state": "open",
"lineItems": [
{
"name": "Test Item 1",
"price": 1200
},
{
"name": "Test Item 2",
"price": 1800
}
]
}
}'Affected endpoints:
- All HTTP API requests
