# BulkSMS.com BulkSMS JSON REST API API

> BulkSMS.com BulkSMS JSON REST API API on Apizie: 15 endpoints (List blocked numbers, Create a blocked number, Transfer credits to another account, Retrieve Messages, …) 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://zieapi.vercel.app/v1/communication:bulksms/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `communication:bulksms`
- Category: Communication
- Status: byok
- Source: https://www.bulksms.com
- Page: https://zieapi.vercel.app/api/communication/bulksms
- OpenAPI: https://zieapi.vercel.app/api/communication/bulksms/openapi.json

## Overview The JSON REST API allows you to submit and receive [BulkSMS](https://www.bulksms.com/) messages. You can also get access to past messages and see your account profile. The base URL to use for this service…

## Endpoints

### List blocked numbers
`GET https://zieapi.vercel.app/v1/communication:bulksms/blocked-numbers-list-retrieval` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| min-id | integer | no | Records with an `id` that is greater or equal to min-id will be returned. The default value is `0`. You can add 1 to an id that you… |
| limit | integer | no | The maximum number of records to return. The default value is `10000`. The value cannot be greater than 10000. |

### Create a blocked number
`POST https://zieapi.vercel.app/v1/communication:bulksms/blocked-numbers-create-blocked-number` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Transfer credits to another account
`POST https://zieapi.vercel.app/v1/communication:bulksms/credits-transfer-credits-to-account` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Retrieve Messages
`GET https://zieapi.vercel.app/v1/communication:bulksms/message-list-retrieval` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | number | no | The maximum number of messages that are returned. The default is 1000. The value of `limit` is not a guarantee that a specific number of… |
| filter | string | no | See the message filtering for more information. |
| sortOrder | string | no | The default value is DESCENDING If the `sortOrder` is DESCENDING, the newest messages be first in the result. ASCENDING places the oldest… |

### Send Messages
`POST https://zieapi.vercel.app/v1/communication:bulksms/message-send-batch-messages` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| deduplication-id | integer | no | Safeguards against the possibility of sending the same messages more than once. If a communication failure occurs during a submission, you… |
| auto-unicode | boolean | no | Specifies how to deal with message text that contains characters not present in the GSM 03.38 character set. Messages that contain only… |
| schedule-date | string | no | Allows you to send a message in the future. An example value is `2019-02-18T13:00:00+02:00`. It encodes to… |
| schedule-description | string | no | A note that is stored together with a scheduled submission, which could be used to more easily identify the scheduled submission at a… |
| body | object | yes | JSON request body |

### Send message by simple GET or POST
`GET https://zieapi.vercel.app/v1/communication:bulksms/message-submit-message` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| to | string | yes | The phone number of the recipient. |
| body | string | yes | The text you want to send. |
| deduplication-id | integer | no | Refer to the `deduplication-id` parameter. |

### Show Message
`GET https://zieapi.vercel.app/v1/communication:bulksms/message-by-id-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The `id` of the message you want to retrieve |

### List Related Messages
`GET https://zieapi.vercel.app/v1/communication:bulksms/message-related-received-messages-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The `id` of the sent message |

### Get profile
`GET https://zieapi.vercel.app/v1/communication:bulksms/profile-get-user-information` (byok)

### Upload an attachment via a signed URL
`POST https://zieapi.vercel.app/v1/communication:bulksms/attachments-upload-via-pre-signed-url` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### List webhooks
`GET https://zieapi.vercel.app/v1/communication:bulksms/webhooks-list-webhooks` (byok)

### Create a webhook
`POST https://zieapi.vercel.app/v1/communication:bulksms/webhooks-create-webhook` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Read a webhook
`GET https://zieapi.vercel.app/v1/communication:bulksms/webhooks-read-webhook` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The `id` of the webhook |

### Update a webhook
`POST https://zieapi.vercel.app/v1/communication:bulksms/webhooks-update-webhook` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The `id` of the webhook |
| body | object | yes | JSON request body |

### Delete a webhook
`POST https://zieapi.vercel.app/v1/communication:bulksms/webhooks-delete-webhook` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The `id` of the webhook |

## Example
```
curl "https://zieapi.vercel.app/v1/communication:bulksms/blocked-numbers-list-retrieval" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the BulkSMS.com BulkSMS JSON REST API API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/communication:bulksms/blocked-numbers-list-retrieval with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the BulkSMS.com BulkSMS JSON REST API API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. BulkSMS.com BulkSMS JSON REST API itself also needs your own key from api.bulksms.com.

### Can AI agents use the BulkSMS.com BulkSMS JSON REST API API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key communication:bulksms.

### What is the status of the BulkSMS.com BulkSMS JSON REST API API?
Needs your own provider key (bring your own key)