Skip to main content
The carousel offer endpoint creates an offer formatted for presentation in a product carousel UI element. Use this when your rewards interface displays products in a horizontal scrollable carousel.

​
Endpoint

POST /offers/carousel
No authentication required.

​
Request Body

Same structure as POST /offers/single — a single OfferMessage with a product_click object and a product_info object.

​
Example Request

curl -X POST https://rewardsbot-prod.liquidrewardsapi.com/offers/carousel \
  -H "Content-Type: application/json" \
  -d '{
    "product_click": {
      "program": "my-loyalty-program",
      "email": "user@example.com",
      "convo_id": "session-abc123",
      "presentation_id": "pres-002",
      "click_id": "click-002",
      "click_datetime": "2024-01-15T10:30:00Z"
    },
    "product_info": {
      "name": "Adidas Ultraboost 24",
      "direct_link": "https://affiliate.net/track?id=002",
      "detail_link": "https://adidas.com/ultraboost",
      "image_url": "https://cdn.example.com/ultraboost.jpg",
      "value": 190.00,
      "price": "$190.00",
      "description": "Premium running shoe with Boost cushioning",
      "presentment_id": "pres-002",
      "merchant": { "id": 2, "name": "Adidas" }
    }
  }'

​
Response

Returns HTTP 201 Created with an OfferReference or MessageAck. 
{ "id": 99 }

​
Error Responses

StatusDescription
422 Unprocessable EntityValidation error in the request body.