> For the complete documentation index, see [llms.txt](https://doc.antgst.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.antgst.com/ant-api/sms/marketing-sms/send-marketing-sms.md).

# Send Marketing SMS

Send marketing SMS

**Url**

<mark style="color:blue;">**`POST`**</mark>    **`https://wa.antgst.com/sms/txt/1/send/json`**

**Content-Type**

**`application/json`**

**Request Body**

<table><thead><tr><th width="124.33331298828125">NameType</th><th width="131">Description</th><th width="103.6666259765625">Required</th><th>Description</th></tr></thead><tbody><tr><td><a href="/introduction/authentication.md#api-key-1">authSecret</a></td><td>string</td><td>Yes</td><td><a href="/introduction/authentication.md#api-key">API Key(AccessKey ID+ AccessKey Secret)</a></td></tr><tr><td>from</td><td>String</td><td>No</td><td>SenderID</td></tr><tr><td><a href="/introduction/number.md">numbers</a></td><td><strong>Array</strong></td><td>Yes</td><td>Receive number,Receive phone format like: <strong>countryCode+phone</strong>: <strong>006281213131213</strong><br>Maximum quantity per request: 2000 numbers</td></tr><tr><td>sms</td><td>String</td><td>Yes</td><td>Sms content</td></tr></tbody></table>

**Curl Example：**&#x52;equest timeout ≥ 3s

```sh
curl --request POST 
  --url https://wa.antgst.com/sms/txt/1/send/json 
  --header 'content-type: application/json' 
  --data '{
    "authSecret":"6b43ccc24d864f26xxxxxxxxxx530e47db959921e0a55b9499",
    "from":"1234",
    "numbers":["0091xxxx08424"],
    "sms":"test sms"
}'
```

**Response**

{% tabs %}
{% tab title="200 success" %}

```json
{
    "msg": "SUCCESS",
    "code": 200,
    "result": [
        {
            "number": "0091xxxx08424",
            "smsId": "e95f2754f557xxxxde688a509ee63b0",
            "code": 200,
            "result": "success"
        }
    ]
}
```

{% endtab %}

{% tab title="400 fail" %}

```json
{
	"msg": "auth secret error!",
	"code": -22
}
```

{% endtab %}
{% endtabs %}

**Response parameter description**

| Filed                                | Description                       |
| ------------------------------------ | --------------------------------- |
| msg                                  | response result information       |
| [code](/introduction/errors.md#code) | response status code              |
| result                               | response result parameter         |
| result.number                        | balance of SMS service            |
| result.smsId                         | SMS Unique ID                     |
| result.code                          | Response status code for each SMS |
| result.result                        | Response information for each SMS |