# send-message-template-per-number

**POST** `/api/v1/send-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-message`

Authentication location: `none`

Authentication name: `none`

### Request schema


```json
{
  "type": "object",
  "properties": {
    "category": {
      "type": "string"
    },
    "messages": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "to": {
            "type": "string"
          },
          "ttl": {
            "type": "string"
          },
          "variables": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "key": {
                  "type": "string"
                },
                "value": {
                  "type": "string"
                }
              }
            }
          },
          "templateId": {
            "type": "string"
          },
          "isSMSFallbackRequired": {
            "type": "boolean"
          }
        }
      }
    },
    "correlationId": {
      "type": "string"
    }
  }
}
```

### Request example


```json
{
  "category": "promotional",
  "messages": [
    {
      "to": "8446779594",
      "ttl": "10",
      "variables": [
        {
          "key": "OTP",
          "value": "123"
        },
        {
          "key": "user",
          "value": "Jayant"
        }
      ],
      "templateId": "67ed02fb0ebf1303afe5e09f",
      "isSMSFallbackRequired": false
    },
    {
      "to": "7972086759",
      "ttl": "10",
      "variables": [
        {
          "key": "OTP",
          "value": "123"
        },
        {
          "key": "user",
          "value": "Jayant"
        }
      ],
      "templateId": "67ed02fb0ebf1303afe5e09f",
      "isSMSFallbackRequired": false
    }
  ],
  "correlationId": "dfsdfaccv234"
}
```

## Response schema


```json
{
  "type": "object",
  "properties": {
    "code": {
      "type": "integer"
    },
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "mobile": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "uniqueId": {
            "type": "string"
          },
          "templateId": {
            "type": "string"
          }
        }
      }
    },
    "status": {
      "type": "string"
    },
    "requestId": {
      "type": "string"
    },
    "correlationId": {
      "type": "string"
    },
    "totalMessages": {
      "type": "integer"
    }
  }
}
```

## Response examples


```json
{
  "200": {
    "code": 200,
    "data": [
      {
        "mobile": "+918446779594",
        "message": "success",
        "uniqueId": "PROD_68218acedb298103bc8d5931_APIdfsdfaccv234-20250728_9a80c9e800",
        "templateId": "67ed02fb0ebf1303afe5e09f"
      },
      {
        "mobile": "+917972086759",
        "message": "success",
        "uniqueId": "PROD_68218acedb298103bc8d5931_APIdfsdfaccv234-20250728_a458fff700",
        "templateId": "67ed02fb0ebf1303afe5e09f"
      }
    ],
    "status": "SUCCESS",
    "requestId": "af16b3e2-aefc-44a2-9e1c-885bcf252afc",
    "correlationId": "dfsdfaccv234",
    "totalMessages": 2
  }
}
```

## Status codes


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