BulkGate SMS API
★ Only Publicly Available OpenAPI DocumentCommunicationsSms MessagingapiKey7 EndpointsREST
For Agents
Send transactional or promotional SMS through BulkGate and check the account credit balance across 7 endpoints.
Use for: I need to send a one-time password to a customer's phone, Send a promotional SMS campaign to a list of subscribers, Check the remaining BulkGate credit balance before a campaign, Send a delivery notification SMS for an e-commerce order
Not supported: Does not handle voice calls, email, contact list management, or inbound SMS reply routing — use for outbound transactional and promotional SMS and credit checks only.
Jentic publishes the only available OpenAPI specification for BulkGate SMS API, keeping it validated and agent-ready. BulkGate is a multichannel messaging platform focused on transactional and promotional SMS at scale, with both a simple sending mode and an advanced mode that supports per-recipient personalization. The API exposes 7 endpoints covering simple SMS, advanced SMS in two versions, and an account credit check. Use it for two-factor codes, order updates, marketing pushes, and any workflow that needs to drop a text message into the customer's phone with delivery tracking.
Install Jentic One Beta
Connect the BulkGate SMS API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the BulkGate SMS API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with BulkGate SMS API.
Send a single transactional SMS to a recipient with the simple endpoint
Send a single promotional SMS with sender ID and unicode handling
Send a personalised batch of transactional SMS with per-recipient variables
Send a personalised batch of promotional SMS using the advanced v2 surface
Check the current credit balance on the BulkGate account
Specify a sender ID, country, and unicode setting per send
Choose between v1 and v2 of the advanced send endpoints
Use Cases
Patterns agents use BulkGate SMS API for, with concrete tasks.
★ OTP and Two-Factor Delivery
Send one-time passwords for login, password reset, and high-risk action confirmation. The agent posts a generated code to /api/1.0/simple/transactional with the customer phone number and sender ID. Transactional routing prioritises delivery latency, so codes typically arrive within seconds — call /api/2.0/advanced/info ahead of campaigns to confirm the account has enough credit.
Send the SMS Your verification code is 482910 to phone +420601234567 from sender CompanyApp via the transactional endpoint.
Order and Shipping Notifications
Drive customer order updates from a commerce backend. When an order ships, the agent calls the simple transactional endpoint with the carrier and tracking number. The advanced endpoints support per-recipient variables, so a single batch payload can deliver tailored updates to thousands of customers without iterating one request per recipient.
Send a personalised batch via /api/2.0/advanced/transactional containing 500 order updates, each with the customer's name and tracking number substituted.
Promotional Campaigns
Run promotional SMS campaigns with the advanced v2 endpoint, which accepts batch recipients and per-recipient personalization. Combine it with a credit balance check via /api/2.0/advanced/info so the orchestrating script aborts cleanly if the balance is too low to fulfil the entire send rather than silently truncating.
Check the BulkGate credit balance, and if above 5000 credits send a promotional batch of 1500 messages with a per-recipient first-name variable.
AI Agent Notification Service via Jentic
An agent connected via Jentic can be told send Lisa a reminder about her appointment by SMS and translate that into a single transactional send. The agent searches Jentic for send sms, loads the POST /api/1.0/simple/transactional schema, and executes against the operator's vault-stored BulkGate application_id and application_token without exposing them to the model.
Search Jentic for send a transactional SMS via BulkGate, load the schema, and send the user-provided message to the user-provided phone number.
Key Endpoints
7 endpoints — jentic publishes the only available openapi specification for bulkgate sms api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
POST
/api/1.0/simple/transactional
Send a single transactional SMS
POST
/api/1.0/simple/promotional
Send a single promotional SMS
POST
/api/2.0/advanced/transactional
Send personalised transactional SMS batch (v2)
POST
/api/2.0/advanced/promotional
Send personalised promotional SMS batch (v2)
POST
/api/2.0/advanced/info
Check account credit balance
POST
/api/1.0/simple/transactional
Send a single transactional SMS
POST
/api/1.0/simple/promotional
Send a single promotional SMS
POST
/api/2.0/advanced/transactional
Send personalised transactional SMS batch (v2)
POST
/api/2.0/advanced/promotional
Send personalised promotional SMS batch (v2)
POST
/api/2.0/advanced/info
Check account credit balance
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
Your BulkGate application_id and application_token pair is stored encrypted in the Jentic vault. Agents never see either value — Jentic merges both into the request body at execution time and returns only the API response.
Intent-based discovery
Agents search Jentic with intents like send a transactional SMS or check sms credit, and Jentic returns the matching BulkGate operations with full input schemas, so the agent calls the right endpoint without browsing docs.
Time to first call
Direct BulkGate integration: half a day to wire up the body-based auth, sender ID configuration, and credit-balance pre-check. Through Jentic: under 30 minutes — search, load, execute.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using BulkGate SMS API through Jentic.
Why is there no official OpenAPI spec for BulkGate SMS API?
BulkGate documents its API in human-readable form but does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call BulkGate SMS API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the BulkGate SMS API use?
BulkGate authenticates using an application_id and application_token pair sent in the JSON request body, both obtained from the BulkGate Portal under API administration. Through Jentic, both values are stored encrypted in the vault and merged into the request body at execution time.
What is the difference between simple and advanced SMS endpoints in BulkGate?
Simple endpoints (/api/1.0/simple/transactional and /promotional) send a single message to one or more numbers with shared content. Advanced endpoints (/api/1.0/advanced/* and /api/2.0/advanced/*) accept per-recipient variables for personalisation in a single request, useful for batch campaigns.
Can I check the BulkGate credit balance through the API?
Yes. POST /api/2.0/advanced/info returns the current credit balance for the authenticated account. Call it before sending a large campaign to confirm there is enough credit to cover the full send rather than partially failing mid-batch.
What are the rate limits for the BulkGate SMS API?
BulkGate enforces per-account throughput limits that are not encoded in the OpenAPI spec. Add retry-with-backoff for HTTP 429 responses and prefer the advanced batch endpoints over many simple sends to stay within fair-use thresholds.
How do I send an SMS from an AI agent through Jentic?
Run pip install jentic and authenticate with your ak_* key. Search Jentic with send a transactional SMS via BulkGate, load the POST /api/1.0/simple/transactional operation, and execute it with the recipient phone, sender ID, and message text. Jentic injects application_id and application_token from your stored credentials.
GET STARTED