Added

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:

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