# FreeFlow | Carousel

**POST** `/api/v1/send-freeflow-message`

Product: [RCS](https://devdocs.pinnacle.in/docs/rcs.md)  
Version: [1.0](https://devdocs.pinnacle.in/docs/rcs/1-0.md)

## Request

URL: `https://api.example.com/rcs/api/v1/send-freeflow-message`

Authentication location: `header`

Authentication name: `Authorization: Bearer <TOKEN>`

### Request schema


```json
{
  "type": "object",
  "properties": {
    "to": {
      "type": "string"
    },
    "category": {
      "type": "string"
    },
    "correlationId": {
      "type": "string"
    },
    "messagePayload": {
      "type": "object",
      "properties": {
        "templateType": {
          "type": "string"
        },
        "richCardCarouselDetails": {
          "type": "object",
          "properties": {
            "cardWidth": {
              "type": "string"
            },
            "cardsList": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "cardMedia": {
                    "type": "object",
                    "properties": {
                      "url": {
                        "type": "string"
                      },
                      "type": {
                        "type": "string"
                      }
                    }
                  },
                  "cardTitle": {
                    "type": "string"
                  },
                  "cardDescription": {
                    "type": "string"
                  },
                  "suggestionsList": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "urlAction": {
                          "type": "string"
                        },
                        "typeOfAction": {
                          "type": "string"
                        },
                        "suggestionText": {
                          "type": "string"
                        },
                        "suggestionPostback": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            },
            "mediaHeight": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

### Request example


```json
{
  "to": "917972086759",
  "category": "promotional",
  "correlationId": "jayant1938",
  "messagePayload": {
    "templateType": "carousel",
    "richCardCarouselDetails": {
      "cardWidth": "MEDIUM_WIDTH",
      "cardsList": [
        {
          "cardMedia": {
            "url": "https://images.pexels.com/photos/1366942/pexels-photo-1366942.jpeg",
            "type": "image"
          },
          "cardTitle": "Laptop Pro Series",
          "cardDescription": "High-performance laptop for professionals with advanced graphics and all-day battery life.",
          "suggestionsList": [
            {
              "urlAction": "https://google.com",
              "typeOfAction": "url_action",
              "suggestionText": "From ₹89,999",
              "suggestionPostback": "laptop_pro_configure"
            }
          ]
        },
        {
          "cardMedia": {
            "url": "https://images.pexels.com/photos/1366942/pexels-photo-1366942.jpeg",
            "type": "image"
          },
          "cardTitle": "Tablet Ultra",
          "cardDescription": "Versatile tablet with premium display, perfect for creativity and productivity tasks.",
          "suggestionsList": [
            {
              "urlAction": "https://store.example.com/tablet-ultra",
              "typeOfAction": "url_action",
              "suggestionText": "From ₹54,999",
              "suggestionPostback": "tablet_ultra_purchase"
            }
          ]
        },
        {
          "cardMedia": {
            "url": "https://images.pexels.com/photos/1366942/pexels-photo-1366942.jpeg",
            "type": "image"
          },
          "cardTitle": "Smartwatch Elite",
          "cardDescription": "Advanced health monitoring, GPS, and smart features in a premium design.",
          "suggestionsList": [
            {
              "urlAction": "https://store.example.com/smartwatch-elite",
              "typeOfAction": "url_action",
              "suggestionText": "₹24,999",
              "suggestionPostback": "smartwatch_elite_shop"
            }
          ]
        }
      ],
      "mediaHeight": "MEDIUM"
    }
  }
}
```

## Response schema


```json
{}
```

## Response examples


```json
{}
```

## Status codes


```json
[
  {
    "code": 200,
    "description": "Successful response"
  }
]
```