# Sending Messages To Subscribers (API)

You can send standard messages to your subscribers via our RESTful API by making the following **POST** request: 

{% tabs %}
{% tab title="Request" %}

```hsts
https://subscription-api.mobivate.com/subscriptions/v1/<campaign_id>/message
```

{% endtab %}

{% tab title="JSON Data" %}

```json
{
    "msisdn":"xxxxxxxxxxx"
    "keyword":"xxxxxxxx"
    "provider":"default"
    "cost":"100"
    "message":"Hello World"
    "signature":"xxxxxxxxxxxxxxxxxx"
}
```

{% endtab %}
{% endtabs %}

### Parameters

The only parameter required for the request is the message you want to send your subscribers.&#x20;

| Parameter | Description                                                                                                                                      |
| --------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| msisdn    | The unique **MSISDN** you are trying to unsubscribe.                                                                                             |
| keyword   | Your unique Mobivate keyword.                                                                                                                    |
| provider  | Network provider to use for the message. Can be either `default` or `premium`.                                                                   |
| cost      | The cost of the message to your subscriber, for example: `100`.                                                                                  |
| message   | Your message, for example: `Hello World!`                                                                                                        |
| signature | Unique parameter consisting of three values: **campaign\_id**, **msisdn** and **account\_id**. For example:  `1af289e14aa593c843da7cd869a8e2f7`. |

### Successful response

If your user has been sent a message successfully you will receive the following response, **HTTP Status Code 200**:

```json
{
  "authenticated" : True,
  "valid_msisdn" : True,
  "valid_campaign" : True,
  "campaign_status" : "active",
  "campaign_name" : "Test Campaign",
  "campaign_service" : "12345",
  "state" : "queued"
  "error" : Null,
  "reference": "AP:aaaaaaa-bbbbbbbbb-cccccccc"
}
```