# Tencent Cloud Short Message Service API

> Tencent Cloud Short Message Service API on Apizie: 20 endpoints (Add Sms Sign, Add Sms Template, Callback Status Statistics, Delete Sms Sign, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://www.apizie.tech/v1/cloud:tencent-sms/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:tencent-sms`
- Category: Cloud
- Status: byok
- Source: https://www.tencentcloud.com/document/api
- Page: https://www.apizie.tech/api/cloud/tencent-sms
- OpenAPI: https://www.apizie.tech/api/cloud/tencent-sms/openapi.json

Tencent Cloud API 3.0 for Short Message Service (sms). Every call is signed with TC3-HMAC-SHA256 using your SecretId and SecretKey.

## Endpoints

### Add Sms Sign
`POST https://www.apizie.tech/v1/cloud:tencent-sms/add-sms-sign` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| SignName | string | yes |  |
| SignType | integer | yes |  |
| DocumentType | integer | yes |  |
| International | integer | yes |  |
| SignPurpose | integer | yes |  |
| ProofImage | string | yes |  |
| CommissionImage | string | no |  |
| Remark | string | no |  |
| QualificationId | integer | no |  |

### Add Sms Template
`POST https://www.apizie.tech/v1/cloud:tencent-sms/add-sms-template` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| TemplateName | string | yes |  |
| TemplateContent | string | yes |  |
| SmsType | integer | yes |  |
| International | integer | yes |  |
| Remark | string | yes |  |

### Callback Status Statistics
`POST https://www.apizie.tech/v1/cloud:tencent-sms/callback-status-statistics` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| BeginTime | string | yes |  |
| EndTime | string | yes |  |
| SmsSdkAppId | string | yes |  |
| Limit | integer | yes |  |
| Offset | integer | yes |  |

### Delete Sms Sign
`POST https://www.apizie.tech/v1/cloud:tencent-sms/delete-sms-sign` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| SignId | integer | yes |  |

### Delete Sms Template
`POST https://www.apizie.tech/v1/cloud:tencent-sms/delete-sms-template` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| TemplateId | integer | yes |  |

### Describe Phone Number Info
`POST https://www.apizie.tech/v1/cloud:tencent-sms/describe-phone-number-info` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| PhoneNumberSet | array | yes |  |

### Describe Send Record List
`POST https://www.apizie.tech/v1/cloud:tencent-sms/describe-send-record-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| PhoneNumber | string | yes |  |
| SmsSdkAppId | string | yes |  |
| BeginTime | integer | yes |  |
| EndTime | integer | no |  |
| Limit | integer | no |  |
| Offset | integer | no |  |

### Describe Sms Sign List
`POST https://www.apizie.tech/v1/cloud:tencent-sms/describe-sms-sign-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| International | integer | yes |  |
| SignIdSet | array | no |  |
| Limit | integer | no |  |
| Offset | integer | no |  |

### Describe Sms Template List
`POST https://www.apizie.tech/v1/cloud:tencent-sms/describe-sms-template-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| International | integer | yes |  |
| TemplateIdSet | array | no |  |
| Limit | integer | no |  |
| Offset | integer | no |  |

### Modify Sms Sign
`POST https://www.apizie.tech/v1/cloud:tencent-sms/modify-sms-sign` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| SignId | integer | yes |  |
| SignName | string | yes |  |
| SignType | integer | yes |  |
| DocumentType | integer | yes |  |
| International | integer | yes |  |
| SignPurpose | integer | yes |  |
| ProofImage | string | yes |  |
| CommissionImage | string | no |  |
| Remark | string | no |  |
| QualificationId | integer | no |  |

### Modify Sms Template
`POST https://www.apizie.tech/v1/cloud:tencent-sms/modify-sms-template` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| TemplateId | integer | yes |  |
| TemplateName | string | yes |  |
| TemplateContent | string | yes |  |
| SmsType | integer | yes |  |
| International | integer | yes |  |
| Remark | string | yes |  |

### Pull Sms Reply Status
`POST https://www.apizie.tech/v1/cloud:tencent-sms/pull-sms-reply-status` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Limit | integer | yes |  |
| SmsSdkAppId | string | yes |  |

### Pull Sms Reply Status By Phone Number
`POST https://www.apizie.tech/v1/cloud:tencent-sms/pull-sms-reply-status-by-phone-number` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| BeginTime | integer | yes |  |
| Offset | integer | yes |  |
| Limit | integer | yes |  |
| PhoneNumber | string | yes |  |
| SmsSdkAppId | string | yes |  |
| EndTime | integer | no |  |

### Pull Sms Send Status
`POST https://www.apizie.tech/v1/cloud:tencent-sms/pull-sms-send-status` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Limit | integer | yes |  |
| SmsSdkAppId | string | yes |  |

### Pull Sms Send Status By Phone Number
`POST https://www.apizie.tech/v1/cloud:tencent-sms/pull-sms-send-status-by-phone-number` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| BeginTime | integer | yes |  |
| Offset | integer | yes |  |
| Limit | integer | yes |  |
| PhoneNumber | string | yes |  |
| SmsSdkAppId | string | yes |  |
| EndTime | integer | no |  |

### Report Conversion
`POST https://www.apizie.tech/v1/cloud:tencent-sms/report-conversion` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| SmsSdkAppId | string | yes |  |
| SerialNo | string | yes |  |
| ConversionTime | integer | no |  |

### Send Multi Global Sms
`POST https://www.apizie.tech/v1/cloud:tencent-sms/send-multi-global-sms` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| SmsSdkAppId | string | yes |  |
| MultiSmsInfoSet | array | yes |  |

### Send Sms
`POST https://www.apizie.tech/v1/cloud:tencent-sms/send-sms` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| PhoneNumberSet | array | yes |  |
| SmsSdkAppId | string | yes |  |
| TemplateId | string | yes |  |
| SignName | string | no |  |
| TemplateParamSet | array | no |  |
| ExtendCode | string | no |  |
| SessionContext | string | no |  |
| SenderId | string | no |  |

### Send Status Statistics
`POST https://www.apizie.tech/v1/cloud:tencent-sms/send-status-statistics` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| BeginTime | string | yes |  |
| EndTime | string | yes |  |
| SmsSdkAppId | string | yes |  |
| Limit | integer | yes |  |
| Offset | integer | yes |  |

### Sms Packages Statistics
`POST https://www.apizie.tech/v1/cloud:tencent-sms/sms-packages-statistics` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| SmsSdkAppId | string | yes |  |
| Limit | integer | yes |  |
| Offset | integer | yes |  |
| BeginTime | string | yes |  |
| EndTime | string | yes |  |

## Example
```
curl "https://www.apizie.tech/v1/cloud:tencent-sms/add-sms-sign" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Tencent Cloud Short Message Service API?
Create a free Apizie key, then send POST https://www.apizie.tech/v1/cloud:tencent-sms/add-sms-sign with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Tencent Cloud Short Message Service API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Tencent Cloud Short Message Service itself also needs your own key from tencentcloudapi.com.

### Can AI agents use the Tencent Cloud Short Message Service API?
Yes. Add the Apizie MCP server (https://www.apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:tencent-sms.

### What is the status of the Tencent Cloud Short Message Service API?
Needs your own provider key (bring your own key)