BulkSMS JSON REST API

Name: BulkSMS JSON REST API API
Brand: BulkSMS JSON REST API
Availability: InStock

✓ Official Vendor SpecCommunicationsSms Messagingbasic15 EndpointsREST

For Agents

Send and read SMS, manage RMM attachments, block numbers, transfer credits, and register webhooks across 15 BulkSMS REST endpoints.

Quickstart

Get started with BulkSMS JSON REST API in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"send a BulkSMS message"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with BulkSMS JSON REST API API.

Send a single SMS via simple GET or POST or a batch via the messages POST endpoint

Retrieve sent and received messages with their delivery status and metadata

Pre-sign an upload URL to attach media to an RMM message

List and add numbers to the blocked numbers list to suppress sends

GET STARTED

Start building with BulkSMS JSON REST API API

Explore with Jentic

View OpenAPI Document

BulkSMS is a long-running global SMS gateway with strong UK and South African routing and dedicated number support. The JSON REST API covers the full message lifecycle: sending one or many messages, retrieving message history with delivery status, attaching media for RMM (Rich Mobile Messaging), managing blocked numbers, transferring credit between accounts, and registering webhooks for delivery and inbound events. Use it for transactional SMS, two-factor authentication, marketing pushes, and inbound number handling. The API supports both username-password and API token credentials over HTTP Basic auth.

Use Cases

Patterns agents use BulkSMS JSON REST API API for, with concrete tasks.

★ Two-Factor Authentication SMS

Deliver one-time passwords for login flows using BulkSMS as a high-deliverability transactional channel. The agent posts the OTP and recipient to /messages with the to and body fields, then either polls GET /messages/{id} for status or relies on a webhook configured via POST /webhooks to receive a delivery report. BulkSMS routing is well-suited to UK and South African numbers in particular.

Send the message Your code is 392104 to phone +27821112233 via POST /messages and store the returned message id.

Inbound SMS to Webhook

Capture replies to a dedicated number and route them into a help desk or chat agent. POST /webhooks registers a webhook URL for inbound message events, GET /webhooks lists current subscriptions, and DELETE /webhooks/{id} retires one. This gives you a structured webhook event for every reply rather than polling the messages list endpoint.

Bulk Marketing Sends with Block-List Hygiene

Send marketing SMS campaigns while respecting opt-outs. The agent first calls GET /blocked-numbers to confirm the recipient list does not include suppressed numbers, then sends the campaign via POST /messages. POST /blocked-numbers adds new opt-outs as they arrive, keeping future campaigns compliant without extra bookkeeping.

Send a marketing SMS batch to 2000 recipients via POST /messages after filtering out any numbers returned by GET /blocked-numbers.

AI Agent Notification Service via Jentic

An agent connected via Jentic can send transactional SMS in response to natural-language requests like text Maria the meeting is rescheduled. The agent searches Jentic for send sms, loads the POST /messages schema, and executes against the operator's vault-stored BulkSMS API token without exposing the credential to the model.

Search Jentic for send a BulkSMS message, load the POST /messages schema, and send the user-supplied body to the user-supplied phone number.

Key Endpoints

15 endpoints — bulksms is a long-running global sms gateway with strong uk and south african routing and dedicated number support.

METHOD

PATH

DESCRIPTION

POST

/messages

Send messages

GET

/messages/{id}

Show a message

GET

/messages

Retrieve messages

POST

/blocked-numbers

Add a blocked number

POST

/webhooks

Create a webhook

POST

/credit/transfer

Transfer credits to another account

POST

/rmm/pre-sign-attachment

Pre-sign an RMM attachment upload

POST

/messages

Send messages

GET

/messages/{id}

Show a message

GET

/messages

Retrieve messages

POST

/blocked-numbers

Add a blocked number

POST

/webhooks

Create a webhook

POST

/credit/transfer

Transfer credits to another account

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Your BulkSMS API token (token-id and token-secret) is stored encrypted in the Jentic vault. Agents never see either value — Jentic constructs the HTTP Basic Authorization header at execution time and returns only the API response.

Intent-based discovery

Agents search Jentic with intents like send sms or register a webhook, and Jentic returns the matching BulkSMS operations with full input schemas, so the agent calls the right endpoint without browsing docs.

Time to first call

Direct BulkSMS integration: half a day for HTTP Basic auth, base64 encoding, webhook setup, and message-status polling. Through Jentic: under 30 minutes — search, load, execute.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

BulkGate SMS API

BulkGate is a European-focused SMS gateway with batch personalization in the request body; BulkSMS uses standard HTTP Basic auth and emphasises UK and ZA routing.

Choose BulkGate for European bulk routing with per-recipient variables; choose BulkSMS for UK and South African coverage with HTTP Basic auth and a richer webhook surface.

Complementary

Bugfender API

Bugfender captures runtime logs from mobile apps that may use BulkSMS for two-factor codes.

Use Bugfender alongside BulkSMS when debugging end-to-end SMS flows from a mobile client.

Complementary

Buildium API

Buildium triggers tenant-facing events that BulkSMS can fan out as branded SMS reminders.

Pair BulkSMS with Buildium when you need branded rent and maintenance SMS reminders that exceed Buildium's built-in messaging.

FAQs

Specific to using BulkSMS JSON REST API API through Jentic.

What authentication does the BulkSMS JSON REST API use?

BulkSMS uses HTTP Basic auth. You can use either your account username and password or a generated API token (token-id and token-secret) — API tokens are recommended for production. Through Jentic, the credential pair is stored encrypted in the vault and the Basic auth header is constructed at execution time.

Can I send SMS in bulk through the BulkSMS API?

Yes. POST /messages accepts an array of message objects so a single request can dispatch many recipients with different bodies. Use GET /messages/{id} to confirm delivery for individual messages or register a webhook via POST /webhooks for delivery reports.

Does the BulkSMS API support inbound SMS replies?

Yes. Configure a webhook with POST /webhooks pointing at your endpoint, and BulkSMS will deliver inbound message events to it. GET /messages and GET /messages/{id}/relatedReceivedMessages also let you pull received messages and conversation threads on demand.

How do I attach an image to a BulkSMS RMM message?

POST /rmm/pre-sign-attachment returns a signed upload URL. Upload the file to that URL, then reference the returned attachment identifier when calling POST /messages so the message is delivered as RMM with the media attached.

What are the rate limits for the BulkSMS API?

BulkSMS applies per-account throughput limits that depend on your plan and route. The OpenAPI spec does not encode the exact quotas — add retry-with-backoff for HTTP 429 responses and prefer batch sends over many individual calls when dispatching campaigns.

How do I send a BulkSMS message from an AI agent through Jentic?

Run pip install jentic and authenticate with your ak_* key. Search Jentic with send a BulkSMS message, load the POST /messages operation, and execute it with the to and body fields. Jentic injects the Basic auth header from your stored API token without exposing the secret to the agent.