---
updatedAt: 2025-11-04T16:46:39.000Z
agentTools:
  projectIndex: https://docs.gupshup.io/llms.txt
---

# Send Messages to Single Number

You can send specific message to any number mobile through SMS channel by using Gupshup Enterprise SMS API.

## Prerequisites

To  send message to any mobile number by using Gupshup Enterprise SMS API, you should have:

* User ID & password. If you don’t have an account, you can create one at [Gupshup Enterprise SMS](https://enterprise.smsgupshup.com).
* DLT template with messages for customers.

## Send API request

Once you collect the required prerequisites to send SMS, send the API request in the following format:

<Table align={["left"]}>
  <thead>
    <tr>
      <th>

      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        You can send specific message to any number mobile through SMS channel by using Gupshup Enterprise SMS API.
        ** Prerequisites **
        To  send message to any mobile number by using Gu]
      </td>
    </tr>
  </tbody>
</Table>

## Required parameters

<Table align={["left","left","left"]}>
  <thead>
    <tr>
      <th>
        Parameter
      </th>

      <th>
        Value
      </th>

      <th>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        userid
      </td>

      <td>
        The number must be in pure numeric format with no special characters.
      </td>

      <td>
        The account number provided by the Enterprise SMS GupShup.
      </td>
    </tr>

    <tr>
      <td>
        password
      </td>

      <td>
        UrlEncoded string of UTF-8\
        characters
      </td>

      <td>
        Password is provided by Gupshup for authentication of user id. The password must be the same as used to log on to the Enterprise SMS GupShup website.
      </td>
    </tr>

    <tr>
      <td>
        send\_to
      </td>

      <td>
        Phone no. of the receiver
      </td>

      <td>
        The number must be in numbers of a pure numeric format with no special characters.
      </td>
    </tr>

    <tr>
      <td>
        msg
      </td>

      <td>
        UrlEncoded string of UTF-8\
        characters
      </td>

      <td>
        The message that needs to be sent. It can contain alphanumeric & special characters.
      </td>
    </tr>

    <tr>
      <td>
        auth\_scheme
      </td>

      <td>
        Plain
      </td>

      <td>
        Only plain authentication is supported.
      </td>
    </tr>

    <tr>
      <td>
        method
      </td>

      <td>
        sendMessage
      </td>

      <td>
        Method for performing a specific action.
      </td>
    </tr>

    <tr>
      <td>
        v
      </td>

      <td>
        1.1
      </td>

      <td>
        The default version is 1.1, unless otherwise specified.
      </td>
    </tr>

    <tr>
      <td>
        format
      </td>

      <td>
        TEXT, XML, JSON
      </td>

      <td>
        Specific format for response message.
      </td>
    </tr>

    <tr>
      <td>
        msg\_type
      </td>

      <td>
        Text, Unicode\_text, or flash,\
        VCARD, binary
      </td>

      <td>
        Indicates the type of the message to be sent.
      </td>
    </tr>
  </tbody>
</Table>

## Optional parameters

<Table align={["left","left","left"]}>
  <thead>
    <tr>
      <th>
        Parameter
      </th>

      <th>
        Value
      </th>

      <th>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        port
      </td>

      <td>
        Port Number
      </td>

      <td>
        It is a pure number and needs to be specified if the message is being sent to a port.
      </td>
    </tr>

    <tr>
      <td>
        timestamp
      </td>

      <td>
        URL encoded timestamp in the given format
      </td>

      <td>
        A sender can specify a particular time for sending the message. Accepted timestamp formats are:

        1. yyyy-MM-dd HH:mm:ss\
           (2008-11-21 23:12:32 or 2008-3-4 2:44:23)
        2. MM/dd/yy HH:mm:ss\
           (11/21/08 23:12:32 or 3/4/08 2:44:33)
        3. MM/dd/yy hh:mm:ss\
           (11/21/08 12:09:08)
      </td>
    </tr>

    <tr>
      <td>
        mask
      </td>

      <td>
        Alphabetical characters
      </td>

      <td>
        Sender id is to be sent with the SMS. It has to be preconfigured with a 6 character alphabetical sender id for the enterprise account.
      </td>
    </tr>

    <tr>
      <td>
        msg\_id
      </td>

      <td>
        Numeric/Alphanumeric value
      </td>

      <td>
        Custom message ID. This will be attached to the callback URL. You can use your internal IDs to identify the DLRs more easily. 500 characters numeric/alphanumeric value is allowed for message id.
      </td>
    </tr>

    <tr>
      <td>
        extra
      </td>

      <td>
        Alphanumeric characters
      </td>

      <td>
        You can input any text into this parameter and the same value will be forwarded to a callback URL. 50 alphanumeric characters are allowed\
        for this parameter.
      </td>
    </tr>

    <tr>
      <td>
        principalEntityId
      </td>

      <td>
        Numeric characters provided by\
        operators DLT Portal
      </td>

      <td>
        The Entity ID is registered with the DLT platform. Every entity has to register themselves on the operator's DLT portal to send messages.
      </td>
    </tr>

    <tr>
      <td>
        dltTemplateId
      </td>

      <td>
        Numeric characters provided by\
        operators DLT Portal
      </td>

      <td>
        The Template ID is registered with the DLT platform for the Entity ID. Each entity has to register templates to send messages to their registered customers.
      </td>
    </tr>
  </tbody>
</Table>

## Examples

Here are examples of the 2 types of message types. You can replace the highlighted text with your credentials and send the messages.

### Text

```text
https://enterprise.smsgupshup.com/GatewayAPI/rest?msg= Hi%20Test%20Message
&v=1.1&userid=XXXXXXXXX&password=XXXXX&send_to=9XXXXXXXXX&msg_type=text&method=sendMessage
```

Response: success|919899999999|660362025761505631-520576818555598760\
Message on mobile: Hi Test Message

### Unicode

```text
https://enterprise.smsgupshup.com/GatewayAPI/rest?msg=%E0%A4%8F%E0%A4%B8%20%E0%A4%8F%E0%A
4%AE%20%E0%A4%8F%E0%A4%B8%20%E0%A4%97%E0%A4%AA%E0%A4%B6%E0%A4%AA&v=1.1&useri
d=XXXXXXXXX&password=XXXXX&send_to=9XXXXXXXXX&msg_type=Unicode_Text&method=sendMessage
```

Response: success | 919899999999 | 660362044229091694-472194266127262392\
Received on phone: (copy paste into your browser if you can’t see this)