# Freeflow | Richcard

**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`

### Request schema


```json
{
  "type": "object",
  "properties": {
    "to": {
      "type": "string"
    },
    "category": {
      "type": "string"
    },
    "correlationId": {
      "type": "string"
    },
    "messagePayload": {
      "type": "object",
      "properties": {
        "templateType": {
          "type": "string"
        },
        "richCardStandAloneDetails": {
          "type": "object",
          "properties": {
            "media": {
              "type": "object",
              "properties": {
                "url": {
                  "type": "string"
                },
                "type": {
                  "type": "string"
                }
              }
            },
            "cardTitle": {
              "type": "string"
            },
            "cardDescription": {
              "type": "string"
            },
            "cardOrientation": {
              "type": "string"
            },
            "suggestionsList": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "urlAction": {
                    "type": "string"
                  },
                  "typeOfAction": {
                    "type": "string"
                  },
                  "suggestionText": {
                    "type": "string"
                  },
                  "suggestionPostback": {
                    "type": "string"
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
```

### Request example


```json
{
  "to": "+917972086759",
  "category": "promotional",
  "correlationId": "xyz11111",
  "messagePayload": {
    "templateType": "rich_card",
    "richCardStandAloneDetails": {
      "media": {
        "url": "https://images.pexels.com/photos/1366942/pexels-photo-1366942.jpeg",
        "type": "image"
      },
      "cardTitle": "Latest Smartphone Model XYZ",
      "cardDescription": "Experience cutting-edge technology with an advanced camera system, long-lasting battery, and premium design. Available in multiple colors.",
      "cardOrientation": "VERTICAL",
      "suggestionsList": [
        {
          "urlAction": "https://google.com",
          "typeOfAction": "url_action",
          "suggestionText": "Buy Now - ₹49,999",
          "suggestionPostback": "purchase_smartphone_xyz"
        },
        {
          "urlAction": "",
          "typeOfAction": "dialer_action",
          "suggestionText": "Call Expert",
          "phoneNumberToDial": {
            "number": "8001234567",
            "country": "India",
            "countryCode": "+91"
          },
          "suggestionPostback": "expert_consultation"
        },
        {
          "urlAction": "",
          "typeOfAction": "reply",
          "suggestionText": "More Details1",
          "suggestionPostback": "request_details_smartphone"
        },
        {
          "urlAction": "",
          "typeOfAction": "reply",
          "suggestionText": "More Details2",
          "suggestionPostback": "request_details_smartphone"
        }
      ]
    }
  }
}
```

## Response schema


```json
{}
```

## Response examples


```json
{}
```

## Status codes


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