---
updatedAt: 2026-08-24T18:49:27.000Z
agentTools:
  siteIndex: https://developer.rmlconnect.net/llms.txt
  projectIndex: https://developer.rmlconnect.net/route-mobile-project/llms.txt
---

# Send Template and Session Messages API

Send WhatsApp template messages and session messages with dropdown sections for supported message types and API responses.

Use this API to send WhatsApp template messages and session messages to customers.

## Endpoint details

| Field                 | Value                                         |
| --------------------- | --------------------------------------------- |
| URL                   | <https://apis.rmlconnect.net/wba/v1/messages> |
| Authorization         | jwt                                           |
| API Key               | jwt                                           |
| Header parameter name | Authorization                                 |
| Request Body schema   | application/json                              |

## Supported message types

The API supports both template messages and session messages. Expand the dropdowns below to review the supported message types, then use the matching request sample later on this page.

<Accordion title="Template message types" icon="fa-solid fa-file-lines">

<Cards>
  <Card title="Text" icon="fa-solid fa-align-left">Text</Card>
  <Card title="Text with Text Header" icon="fa-solid fa-heading">Text with Text Header</Card>
  <Card title="Media Image" icon="fa-solid fa-image">Media Image</Card>
  <Card title="Media Document" icon="fa-solid fa-file">Media Document</Card>
  <Card title="Media Video" icon="fa-solid fa-video">Media Video</Card>
  <Card title="Auth Copycode" icon="fa-solid fa-copy">Auth Copycode</Card>
  <Card title="Auth Autofill" icon="fa-solid fa-keyboard">Auth Autofill</Card>
  <Card title="Quick Reply With ID" icon="fa-solid fa-reply">Quick Reply With ID</Card>
  <Card title="Carousel" icon="fa-solid fa-images">Carousel</Card>
  <Card title="Copy Code" icon="fa-solid fa-code">Copy Code</Card>
  <Card title="Catalog Thumbnail" icon="fa-solid fa-boxes-stacked">Catalog Thumbnail</Card>
  <Card title="Multi Product Template Messages" icon="fa-solid fa-layer-group">Multi Product Template Messages</Card>
  <Card title="Limited Time Offer" icon="fa-solid fa-clock">Limited Time Offer</Card>
  <Card title="Payment template messages" icon="fa-solid fa-receipt">Payment template messages</Card>
  <Card title="Flow Template Messages" icon="fa-solid fa-diagram-project">Flow Template Messages</Card>
</Cards>

</Accordion>

<Accordion title="Session message types" icon="fa-solid fa-comments">

<Cards>
  <Card title="Session Text" icon="fa-solid fa-align-left">Session Text</Card>
  <Card title="Session Text Reply To" icon="fa-solid fa-reply">Session Text Reply To</Card>
  <Card title="Send Text with Preview URL" icon="fa-solid fa-link">Send Text with Preview URL</Card>
  <Card title="Session Document" icon="fa-solid fa-file">Session Document</Card>
  <Card title="Session Audio" icon="fa-solid fa-volume-high">Session Audio</Card>
  <Card title="Session Image" icon="fa-solid fa-image">Session Image</Card>
  <Card title="Session Video" icon="fa-solid fa-video">Session Video</Card>
  <Card title="Session Location" icon="fa-solid fa-location-dot">Session Location</Card>
  <Card title="Interactive List" icon="fa-solid fa-list">Interactive List</Card>
  <Card title="Session Quick Reply with Media" icon="fa-solid fa-photo-film">Session Quick Reply with Media</Card>
  <Card title="Session Quick Reply with Text" icon="fa-solid fa-message">Session Quick Reply with Text</Card>
  <Card title="Session Single Product" icon="fa-solid fa-box">Session Single Product</Card>
  <Card title="Session Multi Product" icon="fa-solid fa-boxes-stacked">Session Multi Product</Card>
  <Card title="Flow Message" icon="fa-solid fa-diagram-project">Flow Message</Card>
  <Card title="Payment Message with catalog ID" icon="fa-solid fa-credit-card">Payment Message with catalog ID</Card>
  <Card title="Payment Message Without Catalog ID" icon="fa-solid fa-credit-card">Payment Message Without Catalog ID</Card>
  <Card title="Payment Message with Payu Gateway" icon="fa-solid fa-money-check">Payment Message with Payu Gateway</Card>
  <Card title="Payment Message with Razorpay Gateway" icon="fa-solid fa-money-check-dollar">Payment Message with Razorpay Gateway</Card>
  <Card title="Payment Message with UPI" icon="fa-solid fa-indian-rupee-sign">Payment Message with UPI</Card>
  <Card title="Payment Message with Payment Link" icon="fa-solid fa-link">Payment Message with Payment Link</Card>
  <Card title="Payment Order Status" icon="fa-solid fa-clipboard-check">Payment Order Status</Card>
</Cards>

</Accordion>

**1). a).    Send message template - Text**

#### Request Samples

```json
{
  "phone": "{mobile number}",
  "extra": "{your value}",
  "enable_acculync": true,
  "media": {
    "type": "media_template",
    "template_name": "{your template}",
    "lang_code": "{lang_code}",
    "body": [
      {
        "text": "{variable}"
      },
      {
        "text": "{variable}"
      }
    ],
    "button": [
      {
        "button_no": "0/1",
        "url": "{dynamic_url variable}"
      }
    ]
  }
}
```

#### Request Body Schema

* **phone** (required, string) — The mobile number of the recipient in full international format includes a plus sign (+) followed by the country code.
* **extra** (string) — Additional information to include in the message.
* **enable\_acculync** (boolean) — A boolean indicating whether or not to enable Acculync.
* **media** (required, object) — An object containing the details of the message to be sent.

**b).   Text with Text Header:**

#### Request Samples

```json
{
  "phone": "{mobile number}",
  "extra": "{your value}",
  "enable_acculync": true,
  "media": {
    "type": "media_template",
    "lang_code": "{code}",
    "template_name": "{your template}",
    "header": [
      {
        "text": "{variable}"
      }
    ],
    "body": [
      {
        "text": "{variable}"
      },
      {
        "text": "{variable}"
      }
    ],
    "button": [
      {
        "button_no": "0/1",
        "url": "{dynamic_url variable}"
      }
    ]
  }
}
```

**c). Media Image:**

#### Request Samples

```json
{
  "phone": "{mobile number}",
  "extra": "{your value}",
  "enable_acculync": true,
  "media": {
    "type": "media_template",
    "lang_code": "{code}",
    "template_name": "{your template}",
    "header": [
      {
        "image": {
          "link": "{sample image url hosted publicly starting with https:// and ending with file extension}",
          "file_name": "{sample media name and ending with file extension}"
        }
      }
    ],
    "body": [
      {
        "text": "{variable}"
      },
      {
        "text": "{variable}"
      }
    ],
    "button": [
      {
        "button_no": "0/1",
        "url": "{dynamic_url variable}"
      }
    ]
  }
}
```

**d). Media Document:**

#### Request Samples

```json
{
  "phone": "{mobile number}",
  "extra": "{your value}",
  "enable_acculync": true,
  "media": {
    "type": "media_template",
    "lang_code": "{code}",
    "template_name": "{your template}",
    "header": [
      {
        "document": {
          "link": "{sample document url hosted publicly starting with https:// and ending with file extension}",
          "file_name": "{sample media name and ending with file extension}"
        }
      }
    ],
    "body": [
      {
        "text": "{variable}"
      },
      {
        "text": "{variable}"
      }
    ],
    "button": [
      {
        "button_no": "0/1",
        "url": "{dynamic_url variable}"
      }
    ]
  }
}
```

**e). Media Video:**

#### Request Samples

```json
{
  "phone": "{mobile number}",
  "extra": "{your value}",
  "enable_acculync": true,
  "media": {
    "type": "media_template",
    "lang_code": "{code}",
    "template_name": "{your template}",
    "header": [
      {
        "video": {
          "link": "{sample video url hosted publicly starting with https:// and ending with file extension}",
          "file_name": "{sample media name and ending with file extension}"
        }
      }
    ],
    "body": [
      {
        "text": "{variable}"
      },
      {
        "text": "{variable}"
      }
    ],
    "button": [
      {
        "button_no": "0/1",
        "url": "{dynamic_url variable}"
      }
    ]
  }
}
```

#### Request Body Schema

* **phone** (required, string) — The mobile number of the recipient in full international format includes a plus sign (+) followed by the country code.
* **enable\_acculync** (boolean) — A boolean indicating whether or not to enable Acculync.
* **extra** (string) — Additional information to include in the message.
* **media** (required, object) — An object containing the message template details.

**f). Auth Copycode :**

#### Request Samples

```json
{
  "phone": "+91983352xxxx",
  "media": {
    "type": "media_template",
    "template_name": "{template_name}",
    "lang_code": "{lang_code}",
    "body": [
      {
        "text": "123523"
      }
    ],
    "button": [
      {
        "button_type": "authentication",
        "button_no": "0",
        "text": "123523"
      }
    ]
  }
}
```

**g). Auth Autofill :**

#### Request Samples

```json
{
  "phone": "+91983352xxxx",
  "media": {
    "type": "media_template",
    "template_name": "{template_name",
    "lang_code": "{lang_code}",
    "body": [
      {
        "text": "123523"
      }
    ],
    "button": [
      {
        "button_type": "authentication",
        "button_no": "0",
        "text": "123523"
      }
    ]
  }
}
```

#### Request Body Schema

* **phone** (required, string) — The phone number of the recipient.
* **media** (required, object) — An object that represents the media template itself.

**h). Quick Reply With ID :**

#### Request Samples

```json
{
  "phone": "{mobile number}",
  "enable_acculync": true,
  "extra": "extra",
  "media": {
    "type": "media_template",
    "lang_code": "en",
    "template_name": "quick_reply_tim_new",
    "header": [
      {
        "image": {
          "link": "https://upload.wikimedia.org/wikipedia/commons/3/3f/JPEG_example_flower.jpg"
        }
      }
    ],
    "button": [
      {
        "button_no": "0",
        "payload": "tri"
      },
      {
        "button_no": "1",
        "payload": "tan"
      }
    ]
  }
}
```

**i). Carousel :**

#### Request Samples

```json
{
  "phone": "{mobile number}",
  "media": {
    "type": "media_template",
    "template_name": "testing_carousel_pranit",
    "lang_code": "en_US",
    "body": [
      {
        "text": "15OFF"
      },
      {
        "text": "15%"
      }
    ],
    "carousel": [
      {
        "type": "image",
        "url": "https://picsum.photos/id/237/200/300",
        "body": [
          {
            "text": "10OFF"
          },
          {
            "text": "10OFF"
          }
        ],
        "button": [
          {
            "button_no": "0",
            "payload": "7C4xhY"
          },
          {
            "button_no": "1",
            "url": "summer_blues_2023"
          }
        ]
      },
      {
        "type": "image",
        "url": "https://picsum.photos/200/300?grayscale",
        "body": [
          {
            "text": "10OFF"
          },
          {
            "text": "10OFF"
          }
        ],
        "button": [
          {
            "button_no": "0",
            "payload": "7C4xhY"
          },
          {
            "button_no": "1",
            "url": "summer_blues_2023"
          }
        ]
      }
    ]
  }
}
```

**j). Copy Code :**

#### Request Samples

```json
{
  "phone": "{mobile number}",
  "media": {
    "type": "media_template",
    "template_name": "coupon_code_pranit",
    "lang_code": "en_US",
    "body": [
      {
        "text": "Sir"
      },
      {
        "text": "25"
      },
      {
        "text": "DUSSHERA23"
      },
      {
        "text": "24-10-2023"
      }
    ],
    "button": [
      {
        "button_no": "1",
        "coupon_code": "DUSSHERA23"
      }
    ]
  }
}
```

**k). Catalog Thumbnail :**

#### Request Samples

```json
{
  "phone": "{mobile number}",
  "media": {
    "type": "media_template",
    "template_name": "test_pranit_catalogue_2",
    "lang_code": "en_US",
    "body": [
      {
        "text": "Test"
      }
    ],
    "button": [
      {
        "button_no": "0",
        "thumbnail_product_retailer_id": "vendee2"
      }
    ]
  }
}
```

**l). Multi Product Template Message :**

#### Request Samples

```json
{
  "phone": "{mobile number}",
  "media": {
    "type": "media_template",
    "template_name": "testing_api_mpm9",
    "lang_code": "en_us",
    "multi_product": [
      {
        "product_thumbnail": "IT173",
        "title": "image",
        "product_retailer_ids": [
          "1",
          "1-1135-2742-HI"
        ]
      },
      {
        "title": "Premium Packages",
        "product_retailer_ids": [
          "2"
        ]
      },
      {
        "title": "Best Packages",
        "product_retailer_ids": [
          "IT1260"
        ]
      },
      {
        "title": "Premium Packages",
        "product_retailer_ids": [
          "IT173"
        ]
      }
    ]
  }
}
```

**m). Limited Time Offer :**

#### Request Samples

```json
{
  "phone": "{mobile number}",
  "media": {
    "type": "media_template",
    "template_name": "testing_api_lto111",
    "lang_code": "en",
    "body": [
      {
        "text": "Pablo"
      }
    ],
    "limited_time": [
      {
        "expiration_time": 1702373850000,
        "button": [
          {
            "button_no": "0",
            "coupon_code": "CARIBE26"
          }
        ]
      }
    ]
  }
}
```

**n). Payment Template Message :**

#### Request Samples

```json
{
  "phone": "{mobile number}",
  "enable_acculync": "false",
  "media": {
    "type": "media_template",
    "template_name": "testing_order_*************",
    "lang_code": "en_US",
    "payment": [
      {
        "reference_id": "12F14****",
        "order_type": "order_details",
        "product_type": "digital-goods",
        "payment_gateway": {
          "type": "razorpay",
          "configuration_name": "RPca***"
        },
        "address": {
          "first_name": "first name of recipient",
          "address_line1": "address",
          "address_line2": "address",
          "city": "city",
          "state": "state",
          "country": "India",
          "postal_code": "560066"
        },
        "items": [
          {
            "name": "test language",
            "product_id": "106299316140****",
            "quantity": "1",
            "amount": "10",
            "retailer_id": "1-1135-2*****",
            "country_of_origin": "ORIGIN_COUNTRY",
            "importer_name": "IMPORTER_NAME",
            "importer_address": {
              "address_line1": "IMPORTER_ADDRESS",
              "city": "CITY",
              "country_code": "COUNTRY",
              "postal_code": "534280"
            }
          }
        ],
        "subtotal_amount": "10",
        "discount_amount": "0",
        "shipping_amount": "0",
        "shipping_description": "optional_text",
        "total_amount": "10",
        "tax_amount": "0",
        "tax_description": "optional_text"
      }
    ]
  },
  "extra": "samplepayment"
}
```

**O). Flow Template Message:**

#### Request Samples

```json
{
  "phone": "{mobile number}",
  "media": {
    "type": "media_template",
    "template_name": "nn_t***",
    "lang_code": "en",
    "header": [
      {
        "text": "offer"
      }
    ],
    "body": [
      {
        "text": "the end of August"
      },
      {
        "text": "25OFF"
      },
      {
        "text": "20%"
      }
    ],
    "button": [
      {
        "button_no": "0",
        "flow": "PAYLOAD"
      }
    ]
  }
}
```

#### Request Body Schema

* **phone** (required, string) — The phone number of the recipient.
* **enable\_acculync** (boolean) — A boolean indicating whether or not to enable Acculync.
* **extra** (string) — Additional information to include in the message.
* **media** (required, object) — An object containing the message template details.

**2). a).  Session Text:**

#### Request Samples

```json
{
  "phone": "{mobile number}",
  "text": "{sample text}",
  "enable_acculync": true,
  "extra": "{your value}"
}
```

#### Request Body Schema

* **phone** (required, string) — The mobile number of the recipient in full international format includes a plus sign (+) followed by the country code.
* **text** (required, string) — The text to include in the message.
* **enable\_acculync** (boolean) — A boolean indicating whether or not to enable Acculync.
* **extra** (string) — Additional information to include in the message.

**b).  Session Text Reply To:**

#### Request Samples

```json
{
  "phone": "{mobile number}",
  "text": "{sample text}",
  "reply_to": "wamid.HBgMOTE3MDQ1MzQ1Mjg1FQIAERgSQTg5MkYxNjM3QzU5OExxxxxxxx==",
  "enable_acculync": true,
  "extra": "{your value}"
}
```

#### Request Body Schema

* **phone** (required, string) — The mobile number of the recipient in full international format includes a plus sign (+) followed by the country code.
* **text** (required, string) — The text to include in the message.
* **reply\_to** (required, string) — The unique identifier of the message to which the business is replying.
* **enable\_acculync** (boolean) — A boolean indicating whether or not to enable Acculync.
* **extra** (string) — Additional information to include in the message.

**c).  Session Text with Preview URL:**

#### Request Samples

```json
{
  "phone": "{mobile number}",
  "text": "{text with valid url}",
  "preview_url": true,
  "enable_acculync": true,
  "extra": "{your value}"
}
```

#### Request Body Schema

* **phone** (required, string) — The mobile number of the recipient in full international format includes a plus sign (+) followed by the country code.
* **text** (required, string) — The text to include in the message.
* **preview\_url** (boolean) — A boolean value indicating whether to include a preview of the URL in the message.
* **enable\_acculync** (boolean) — A boolean indicating whether or not to enable Acculync.
* **extra** (string) — Additional information to include in the message.

**d).  Session Document:**

#### Request Samples

```json
{
  "phone": "{mobile number}",
  "enable_acculync": true,
  "media": {
    "type": "document",
    "url": "{sample pdf url https://}",
    "file": "{sample .pdf file name}",
    "caption": "{sample text}"
  },
  "extra": "{your value}"
}
```

#### Request Body Schema

* **phone** (required, string) — The mobile number of the recipient in full international format includes a plus sign (+) followed by the country code.
* **enable\_acculync** (boolean) — A boolean indicating whether or not to enable Acculync.
* **media** (required, object) — An object containing the details of the document to be sent.
* **extra** (string) — Additional information to include in the message.

**e).  Session Audio:**

#### Request Samples

```json
{
  "phone": "{mobile number}",
  "enable_acculync": true,
  "media": {
    "type": "audio",
    "url": "{sample .mp3 url https://}",
    "file": "{sample audio.mp3 file name}",
    "caption": "{sample text}"
  },
  "extra": "{your value}"
}
```

#### Request Body Schema

* **phone** (required, string) — The mobile number of the recipient in full international format includes a plus sign (+) followed by the country code.
* **enable\_acculync** (boolean) — A boolean indicating whether or not to enable Acculync.
* **media** (required, object) — An object containing the details of the audio to be sent.
* **extra** (string) — Additional information to include in the message.

**f).  Session Image:**

#### Request Samples

```json
{
  "phone": "{mobile number}",
  "enable_acculync": true,
  "media": {
    "type": "image",
    "url": "{sample image url https://}",
    "file": "{sample image .jpg file name}",
    "caption": "{sample text}"
  },
  "extra": "{your value}"
}
```

#### Request Body Schema

* **phone** (required, string) — The mobile number of the recipient in full international format includes a plus sign (+) followed by the country code.
* **enable\_acculync** (boolean) — A boolean indicating whether or not to enable Acculync.
* **media** (required, object) — An object containing the details of the image to be sent.
* **extra** (string) — Additional information to include in the message.

**g).  Session Video:**

#### Request Samples

```json
{
  "phone": "{mobile number}",
  "enable_acculync": true,
  "media": {
    "type": "video",
    "url": "{sample video url https://}",
    "file": "{sample video .mp4 file name}",
    "caption": "{sample text}"
  },
  "extra": "{your value}"
}
```

#### Request Body Schema

* **phone** (required, string) — The mobile number of the recipient in full international format includes a plus sign (+) followed by the country code.
* **enable\_acculync** (boolean) — A boolean indicating whether or not to enable Acculync.
* **media** (required, object) — An object containing the details of the video to be sent.
* **extra** (string) — Additional information to include in the message.

**h).  Session Location:**

#### Request Samples

```json
{
  "phone": "{mobile number}",
  "enable_acculync": true,
  "media": {
    "type": "location",
    "longitude": "{example: 72.838249}",
    "latitude": "{example: 18.991341}",
    "name": "{location name}",
    "address": "{location address}"
  },
  "extra": "{your value}"
}
```

#### Request Body Schema

* **phone** (required, string) — The mobile number of the recipient in full international format includes a plus sign (+) followed by the country code.
* **enable\_acculync** (boolean) — A boolean indicating whether or not to enable Acculync.
* **media** (required, object) — An object containing the details of the location to be sent on the user's device..
* **extra** (string) — Additional information to include in the message.

**i).  Session Interactive List:**

#### Request Samples

```json
{
  "phone": "{phone number}",
  "extra": "{your value}",
  "enable_acculync": true,
  "media": {
    "type": "interactive_list",
    "header": {
      "text": "ABC Food Items"
    },
    "body": "Hello TAN. Please select from the list below",
    "footer_text": "Menu",
    "button_text": "Select",
    "button": [
      {
        "section_title": "Chicken",
        "row": [
          {
            "id": "1",
            "title": "Chicken Kadai",
            "description": "tasty gravy"
          }
        ]
      },
      {
        "section_title": "Fish",
        "row": [
          {
            "id": "2",
            "title": "Fish Masala",
            "description": "yummy flavour"
          }
        ]
      }
    ]
  }
}
```

#### Request Body Schema

* **phone** (required, string) — The mobile number of the recipient in full international format includes a plus sign (+) followed by the country code.
* **extra** (string) — Additional information to include in the message.
* **enable\_acculync** (boolean) — A boolean indicating whether or not to enable Acculync.
* **media** (required, object) — An object containing the details of the interactive list to be sent.

**j).  Session Quick Reply With Media:**

#### Request Samples

```json
{
  "phone": "{mobile number}",
  "extra": "{your value}",
  "enable_acculync": true,
  "media": {
    "type": "interactive_reply",
    "header": {
      "type": "video",
      "url": "http://commondatastorage.googleapis.com/gtv-videos-bucket/sample/xxxxxxxxxxxxxxxx.mp4",
      "file": "pdf.pdf",
      "caption": "This is a test video"
    },
    "body": "HI TAN, please select an option below",
    "footer_text": "c@2021",
    "button": [
      {
        "id": "1",
        "title": "Yes"
      },
      {
        "id": "2",
        "title": "No"
      },
      {
        "id": "3",
        "title": "Maybe"
      }
    ]
  }
}
```

#### Request Body Schema

* **phone** (required, string) — The mobile number of the recipient in full international format includes a plus sign (+) followed by the country code.
* **extra** (string) — Additional information to include in the message.
* **enable\_acculync** (boolean) — A boolean indicating whether or not to enable Acculync.
* **media** (required, object) — A JSON object that describes the media file and quick reply options.

**k).  Session Quick Reply With Text:**

#### Request Samples

```json
{
  "phone": "{mobile number}",
  "extra": "{your value}",
  "enable_acculync": true,
  "media": {
    "type": "interactive_reply",
    "header": {
      "text": "Super Selector Match"
    },
    "body": "HI TAN, please select an option below",
    "footer_text": "c@2021",
    "button": [
      {
        "id": "1",
        "title": "Yes"
      },
      {
        "id": "2",
        "title": "No"
      },
      {
        "id": "3",
        "title": "Maybe"
      }
    ]
  }
}
```

#### Request Body Schema

* **phone** (required, string) — The mobile number of the recipient in full international format includes a plus sign (+) followed by the country code.
* **extra** (string) — Additional information to include in the message.
* **enable\_acculync** (boolean) — A boolean indicating whether or not to enable Acculync.
* **media** (required, object) — An object containing the details of the interactive reply be sent.

**l).  Session Single Product:**

#### Request Samples

```json
{
  "phone": "{mobile number}",
  "extra": "extra",
  "enable_acculync": true,
  "catalog": {
    "type": "product",
    "body": {
      "text": "test"
    },
    "action": {
      "catalog_id": "2476762038xxxx9",
      "product_retailer_id": "pp_x1"
    }
  }
}
```

**m).  Session Multi Product:**

#### Request Samples

```json
{
  "phone": "{mobile number}",
  "enable_acculync": true,
  "extra": "extra",
  "catalog": {
    "type": "product_list",
    "header": {
      "type": "text",
      "text": "hello https://mail.google.com/"
    },
    "body": {
      "text": "test"
    },
    "action": {
      "catalog_id": "2476762038xxxx9",
      "sections": [
        {
          "title": "section 1",
          "product_items": [
            {
              "product_retailer_id": "pp_x1"
            },
            {
              "product_retailer_id": "pp_x"
            }
          ]
        },
        {
          "title": "section 2",
          "product_items": [
            {
              "product_retailer_id": "pp_x1"
            },
            {
              "product_retailer_id": "pp_x"
            }
          ]
        }
      ]
    }
  }
}
```

#### Request Body Schema

* **phone** (required, string) — The mobile number of the recipient in full international format includes a plus sign (+) followed by the country code.
* **extra** (string) — Additional information to include in the message.
* **enable\_acculync** (boolean) — A boolean indicating whether or not to enable Acculync.
* **catalog** (required, object) — The catalog object contains information about the product list.

**n).  Session Flow:**

#### Request Samples

```json
{
  "phone": "{mobile number}",
  "enable_acculync": false,
  "type": "flow",
  "header": {
    "image": "https://upload.wikimedia.org/wikipedia/commons/3/3f/JPEG_example_flower.jpg"
  },
  "footer": "this test belongs to footer",
  "body": "https://upload.wikimedia.org/wikipedia/commons/3/3f/JPEG_example_flower.jpg",
  "flow": {
    "flow_mode": "draft",
    "flow_token": "abc********.",
    "flow_id": "856082929******",
    "flow_cta": "Book!",
    "flow_action": "navigate",
    "flow_action_payload": {
      "screen": "MY_FIRST_SCREEN",
      "data": {
        "hi": "hello"
      }
    }
  }
}
```

#### Request Body Schema

* **phone** (required, string) — The mobile number of the recipient in full international format includes a plus sign (+) followed by the country code.
* **enable\_acculync** (boolean) — A boolean indicating whether or not to enable Acculync.
* **type** (required, string) — The type of message, in this case "flow".
* **header** (required, object) — The header information for the flow message.
* **footer** (required, string) — Text to display in the footer.
* **body** (required, string) — The URL of the image to display in the body.
* **flow** (required, object) — The flow object contains information about the flow message.

**o).  Payment Message With Catalog ID:**

#### Request Samples

```json
{
  "phone": "{mobile number}",
  "enable_acculync": false,
  "body": "with catalog",
  "footer": "this is your text",
  "image": {
    "url": "https://upload.wikimedia.org/wikipedia/commons/3/3f/JPEG_example_flower.jpg"
  },
  "payment": {
    "reference_id": "q2",
    "order_type": "order_details",
    "product_type": "digital-goods",
    "payment_configuration": "RML****1",
    "address": {
      "first_name": "first name of recipient",
      "address_line1": "address",
      "address_line2": "address",
      "city": "city",
      "state": "state",
      "country": "India",
      "postal_code": "560066"
    },
    "items": [
      {
        "retailer_id": "1",
        "catalog_id": "62305622836*****",
        "product_name": "Product name, for example bread",
        "amount": 100,
        "quantity": "1",
        "expiration_timestamp": "1797885016",
        "expiration_description": "expiration-explanation"
      }
    ],
    "subtotal_amount": 100,
    "discount_amount": 100,
    "discount_description": "optional_text",
    "shipping_amount": 0,
    "shipping_description": "optional_text",
    "total_amount": 100,
    "tax_amount": 100,
    "tax_description": "optional_text"
  },
  "extra": "samplepayment"
}
```

#### Request Body Schema

**p).  Payment Message Without Catalog ID:**

#### Request Samples

```json
{
  "phone": "{mobile number}",
  "enable_acculync": false,
  "body": "without catalog_id",
  "footer": "this is your text",
  "payment": {
    "reference_id": "y**",
    "order_type": "order_details",
    "product_type": "digital-goods",
    "payment_configuration": "RML****1",
    "address": {
      "first_name": "first name of recipient",
      "address_line1": "address",
      "address_line2": "address",
      "city": "city",
      "state": "state",
      "country": "India",
      "postal_code": "560066"
    },
    "items": [
      {
        "image": {
          "url": "https://upload.wikimedia.org/wikipedia/commons/3/3f/JPEG_example_flower.jpg"
        },
        "product_name": "Product name, for example bread",
        "amount": 100,
        "quantity": "1",
        "expiration_timestamp": "1797885016",
        "expiration_description": "expiration-explanation"
      }
    ],
    "subtotal_amount": 100,
    "discount_amount": 100,
    "discount_description": "optional_text",
    "shipping_amount": 0,
    "shipping_description": "optional_text",
    "total_amount": 100,
    "tax_amount": 100,
    "tax_description": "optional_text",
    "extra": "samplepayment"
  }
}
```

#### Request Body Schema

* **phone** (required, string) — The mobile number of the recipient in full international format includes a plus sign (+) followed by the country code.
* **enable\_acculync** (boolean) — A boolean indicating whether or not to enable Acculync.
* **body** (required, string) — The body text of the message.
* **footer** (required, string) — The text to display in the footer.
* **payment** (required, object) — The payment object contains information about the payment details.
* **extra** (required, string) — Additional information to include in the message.

**q).  Payment Message With Payu Gateway:**

#### Request Samples

```json
{
  "phone": "{mobile number}",
  "enable_acculync": false,
  "body": "payment gateway_payu",
  "footer": "this is your text",
  "image": {
    "url": "https://upload.wikimedia.org/wikipedia/commons/3/3f/JPEG_example_flower.jpg"
  },
  "payment": {
    "reference_id": "g**",
    "order_type": "order_details",
    "product_type": "digital-goods",
    "payment_gateway": {
      "type": "payu",
      "configuration_name": "PUca***",
      "notes": {
        "udf1": "TNXID:1221***",
        "udf2": "TNXID:1221WE***",
        "udf3": "TNXID:12WE322***"
      }
    },
    "address": {
      "first_name": "first name of recipient",
      "address_line1": "address",
      "address_line2": "address",
      "city": "city",
      "state": "state",
      "country": "India",
      "postal_code": "560066"
    },
    "items": [
      {
        "retailer_id": "1*",
        "catalog_id": "623056228363****",
        "product_name": "Product name, for example bread",
        "amount": 100,
        "quantity": "1",
        "expiration_timestamp": "1797885016",
        "expiration_description": "expiration-explanation"
      }
    ],
    "subtotal_amount": 100,
    "discount_amount": 100,
    "discount_description": "optional_text",
    "shipping_amount": 0,
    "shipping_description": "optional_text",
    "total_amount": 100,
    "tax_amount": 100,
    "tax_description": "optional_text"
  },
  "extra": "samplepayment"
}
```

**r).  Payment Message With Razorpay Gateway:**

#### Request Samples

```json
{
  "phone": "{mobile number}",
  "enable_acculync": false,
  "body": "payment gateway_ razor",
  "footer": "this is your text",
  "image": {
    "url": "https://upload.wikimedia.org/wikipedia/commons/3/3f/JPEG_example_flower.jpg"
  },
  "payment": {
    "reference_id": "q9*",
    "order_type": "order_details",
    "product_type": "digital-goods",
    "payment_gateway": {
      "type": "razorpay",
      "configuration_name": "Rca***",
      "notes": {
        "udf1": "TNXID:12213**",
        "udf2": "TNXID:1221WEE**",
        "udf3": "TNXID:12WE322***"
      }
    },
    "address": {
      "first_name": "first name of recipient",
      "address_line1": "address",
      "address_line2": "address",
      "city": "city",
      "state": "state",
      "country": "India",
      "postal_code": "560066"
    },
    "items": [
      {
        "retailer_id": "1**",
        "catalog_id": "6230562283637***",
        "product_name": "Product name, for example bread",
        "amount": 100,
        "quantity": "1",
        "expiration_timestamp": "1797885016",
        "expiration_description": "expiration-explanation"
      }
    ],
    "subtotal_amount": 100,
    "discount_amount": 100,
    "discount_description": "optional_text",
    "shipping_amount": 0,
    "shipping_description": "optional_text",
    "total_amount": 100,
    "tax_amount": 100,
    "tax_description": "optional_text"
  },
  "extra": "samplepayment"
}
```

#### Request Body Schema

* **phone** (required, string) — The mobile number of the recipient in full international format includes a plus sign (+) followed by the country code.
* **enable\_acculync** (boolean) — A boolean indicating whether or not to enable Acculync.
* **body** (required, string) — The body text of the message.
* **footer** (required, string) — The text to display in the footer.
* **image** (required, object) — The image object containing the URL of the image.
* **payment** (required, object) — The payment object containing information about the payment details.
* **extra** (required, string) — Additional information to include in the message.

**s).  Payment Message With UPI:**

#### Request Samples

```json
{
  "phone": "{mobile number}",
  "enable_acculync": "true",
  "body": "from upi",
  "footer": "this is your text",
  "image": {
    "url": "https://upload.wikimedia.org/wikipedia/commons/3/3f/JPEG_example_flower.jpg"
  },
  "payment": {
    "reference_id": "qqqqq33fq***",
    "order_type": "order_details",
    "product_type": "digital-goods",
    "payment_configuration": "RMLUA***",
    "address": {
      "first_name": "first name of recipient",
      "address_line1": "address",
      "city": "city",
      "state": "state",
      "country": "India",
      "postal_code": "560066"
    },
    "items": [
      {
        "retailer_id": "1-1135-27*****",
        "product_name": "Cora*****",
        "amount": 10,
        "quantity": "1",
        "expiration_timestamp": "1799885016",
        "expiration_description": "expiration-explanation"
      }
    ],
    "subtotal_amount": 10,
    "discount_description": "optional_text",
    "shipping_amount": 0,
    "shipping_description": "optional_text",
    "total_amount": 10,
    "tax_amount": 0,
    "tax_description": "optional_text"
  },
  "extra": "samplepayment"
}
```

#### Request Body Schema

* **phone** (required, string) — The mobile number of the recipient in full international format includes a plus sign (+) followed by the country code.
* **enable\_acculync** (string) — A string indicating whether or not to enable Acculync. (Note- It is a string here, but it should ideally be a boolean.)
* **body** (required, string) — The body text of the message.
* **footer** (required, string) — The text to display in the footer.
* **image** (required, object) — The image object containing the URL of the image.
* **payment** (required, object) — The payment object containing information about the payment details.
* **extra** (required, string) — Additional information to include in the message.

**t).  Payment Message With Payment Link:**

#### Request Samples

```json
{
  "phone": "{mobile number}",
  "enable_acculync": false,
  "body": "from link",
  "footer": "this is your text",
  "image": {
    "url": "https://upload.wikimedia.org/wikipedia/commons/3/3f/JPEG_example_flower.jpg"
  },
  "payment": {
    "reference_id": "q**",
    "order_type": "order_details",
    "product_type": "digital-goods",
    "payment_link": {
      "uri": "https://***************888888"
    },
    "address": {
      "first_name": "first name of recipient",
      "address_line1": "address",
      "address_line2": "address",
      "city": "city",
      "state": "state",
      "country": "India",
      "postal_code": "560066*********",
      "product_name": "Product name, for example bread",
      "amount": 100,
      "quantity": "1",
      "expiration_timestamp": "1797885016",
      "expiration_description": "expiration-explanation"
    },
    "subtotal_amount": 100,
    "discount_amount": 100,
    "discount_description": "optional_text",
    "shipping_amount": 0,
    "shipping_description": "optional_text",
    "total_amount": 100,
    "tax_amount": 100,
    "tax_description": "optional_text"
  },
  "extra": "samplepayment"
}
```

#### Request Body Schema

* **phone** (required, string) — The mobile number of the recipient in full international format includes a plus sign (+) followed by the country code.
* **enable\_acculync** (boolean) — A boolean indicating whether or not to enable Acculync.
* **body** (required, string) — The body text of the message.
* **footer** (required, string) — The text to display in the footer.
* **image** (required, object) — The image object containing the URL of the image.
* **payment** (required, object) — The payment object containing information about the payment details.
* **extra** (required, string) — Additional information to include in the message.

**u).  Payment Order Status:**

#### Request Samples

```json
{
  "phone": "{mobile number}",
  "enable_acculync": false,
  "body": "this is your text",
  "payment": {
    "product_type": "digital-goods",
    "order_type": "order_status",
    "reference_id": "kjhuhouyouyu*****",
    "order_status": "processing",
    "order_status_description": "optional-text"
  },
  "extra": "samplepayment"
}
```

#### Request Body Schema

* **phone** (required, string) — The mobile number of the recipient in full international format includes a plus sign (+) followed by the country code.
* **enable\_acculync** (boolean) — A boolean indicating whether or not to enable Acculync.
* **body** (required, string) — The body text of the message.
* **payment** (required, object) — The payment object containing information about the order status.
* **extra** (required, string) — Additional information to include in the message.

## Responses

<Accordion title="202 Accepted" icon="fa-solid fa-circle-check">

#### Response

```json
{
  "message": "message received successfully",
  "status": "processing",
  "request_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
```

**Response Schema:** application/json

| Field | Type | Description |
| ----- | ---- | ----------- |
| message | string | The response message. |
| status | string | The status of the message delivery. |
| request_id | string | The request ID of the message. |

</Accordion>

<Accordion title="400 Bad Request" icon="fa-solid fa-circle-exclamation">

#### Response

```json
{
  "message": "The browser (or proxy) sent a request that this server could not understand."
}
```

**Response Schema:** application/json

| Field | Type | Description |
| ----- | ---- | ----------- |
| message | string | The message response. |
| status | string | The status of the message delivery. |
| reason | string | The reason for not processing message. |

</Accordion>

<Accordion title="401 Authentication Failure" icon="fa-solid fa-triangle-exclamation">

#### Response

```json
{
  "message": "Unable to process request",
  "status": "Failed",
  "reason": "Please check the integrity or validity of the token sent."
}
```

**Response Schema:** application/json

| Field | Type | Description |
| ----- | ---- | ----------- |
| message | string | The message response. |
| status | string | The status of message delivery. |
| reason | string | The reason for not processing messages. |

</Accordion>

<Accordion title="404 Page Not Found" icon="fa-solid fa-circle-exclamation">

#### Response

```json
{
  "message": "The requested URL was not found on the server. If you entered the URL manually please check your spelling and try again."
}
```

**Response Schema:** application/json

| Field | Type | Description |
| ----- | ---- | ----------- |
| message | string | The response message. |

</Accordion>

<Accordion title="422 Unprocessable Entity (WebDAV)" icon="fa-solid fa-circle-exclamation">

#### Response

```json
{
  "template_type": [
    "Must be one of: template, text_template, media_template, interactive_template."
  ]
}
```

**Response Schema:** application/json

| Field | Type | Description |
| ----- | ---- | ----------- |
| template_type | Array of strings | The type of the template. |

</Accordion>

<Accordion title="500 Internal Server Error" icon="fa-solid fa-triangle-exclamation">

#### Response

```json
{
  "message": "unable to process request",
  "status": "failed"
}
```

**Response Schema:** application/json

| Field | Type | Description |
| ----- | ---- | ----------- |
| status | string | The status of the template. |
| message | string | The message response. |

</Accordion>