Plivo SMS API
★ Only Publicly Available OpenAPI DocumentCommunicationsSms Messagingbasic4 EndpointsREST
For Agents
Send SMS, MMS, and WhatsApp messages to 200+ countries, check delivery status, and retrieve media attachments through 4 focused endpoints.
Use for: I need to send an SMS to a phone number via Plivo, Check whether my message was delivered successfully, List all messages sent in the last 24 hours, Retrieve the media attachment from an MMS message
Not supported: Does not handle voice calls, phone number provisioning, or notification orchestration — use for SMS, MMS, and WhatsApp messaging delivery only.
Jentic publishes the only available OpenAPI specification for Plivo SMS API, keeping it validated and agent-ready. Send and receive SMS, MMS, and WhatsApp messages to 200+ countries through a straightforward REST API with 4 endpoints. Retrieve message delivery status, list sent messages with filtering, and access media attachments on MMS messages. Supports both single-recipient and bulk messaging with per-message delivery receipts.
Install Jentic One Beta
Connect the Plivo SMS API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Plivo 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 Plivo SMS API.
Send SMS and MMS messages to recipients in 200+ countries with delivery status callbacks
Retrieve detailed delivery status and metadata for any sent message by UUID
List sent messages with date, status, and direction filters for reporting
Access media files attached to MMS messages for content retrieval and archival
Send WhatsApp messages through the same messaging endpoint with template support
Use Cases
Patterns agents use Plivo SMS API for, with concrete tasks.
★ AI Agent SMS Delivery
AI agents send SMS messages through Jentic by searching for the send message operation, loading the schema, and executing with src (sender number), dst (recipient), and text (message body). Jentic handles Basic auth credential injection from the MAXsystem vault so agents never touch the Auth ID or Auth Token. A single POST to /Message delivers the SMS with optional media URLs for MMS.
Send an SMS from +15551234567 to +15559876543 with text 'Your verification code is 483920' via POST /Message and verify the message_uuid is returned
Message Delivery Tracking
Monitor delivery outcomes for sent messages by querying individual message status or listing messages with filters. The API returns delivery state (queued, sent, delivered, failed, undelivered) along with timestamps, carrier information, and error codes for failed deliveries. This enables automated retry logic for undelivered messages and compliance reporting for delivered communications.
Retrieve the delivery status of message UUID 'abc-123-def' via GET /Message/{message_uuid} and check whether the status is 'delivered'
International Bulk Messaging
Deliver SMS messages to recipients in 200+ countries with local number or alphanumeric sender ID support. The API accepts multiple destination numbers in a single request for bulk sends, with per-recipient delivery tracking. Pricing varies by country and number type, with competitive rates for high-volume international messaging.
Send an SMS to 5 recipients across different countries in a single POST /Message request with a delimiter-separated dst field and retrieve individual delivery statuses
MMS Media Messaging
Send multimedia messages with image, video, or document attachments through the same messaging endpoint. Include media URLs in the send request and the API handles content delivery to the recipient's device. Retrieve media attachments from received MMS messages via the media endpoint for content processing or archival.
Send an MMS with an image attachment by including a media_url in POST /Message, then retrieve the media list via GET /Message/{message_uuid}/Media
Key Endpoints
4 endpoints — jentic publishes the only available openapi specification for plivo sms api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
POST
/Message
Send an SMS or MMS message to one or more recipients
GET
/Message
List sent messages with optional filters
GET
/Message/{message_uuid}
Get delivery status and details for a specific message
GET
/Message/{message_uuid}/Media
List media attachments for an MMS message
POST
/Message
Send an SMS or MMS message to one or more recipients
GET
/Message
List sent messages with optional filters
GET
/Message/{message_uuid}
Get delivery status and details for a specific message
GET
/Message/{message_uuid}/Media
List media attachments for an MMS message
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
Plivo Auth ID and Auth Token are stored encrypted in the Jentic vault (MAXsystem). Agents receive pre-authenticated requests — raw credentials never enter the agent context or appear in logs.
Intent-based discovery
Agents search by intent (e.g., 'send an SMS message') and Jentic returns the matching Plivo message operation with its input schema, so the agent can construct the request without parsing documentation.
Time to first call
Direct Plivo integration: 1-2 days for auth setup, number provisioning, and error handling. Through Jentic: under 30 minutes — search, load schema, execute.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using Plivo SMS API through Jentic.
Why is there no official OpenAPI spec for Plivo SMS API?
Plivo does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Plivo 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 Plivo SMS API use?
The Plivo API uses HTTP Basic authentication with your Auth ID as the username and Auth Token as the password. The Auth ID is also embedded in the URL path as /v1/Account/{auth_id}/. Through Jentic, these credentials are stored encrypted in the MAXsystem vault and injected automatically into the Basic auth header.
Can I send MMS messages with the Plivo API?
Yes. Include a media_urls array in your POST /Message request with publicly accessible URLs pointing to images, videos, or documents. The API supports multiple media attachments per message. Retrieve received media via GET /Message/{message_uuid}/Media.
What are the rate limits for the Plivo SMS API?
Plivo enforces sending limits based on your number type and account tier. US long codes support 1 SMS per second per number. Short codes and toll-free numbers support higher throughput. The API returns appropriate error codes when limits are exceeded. Contact Plivo for volume-based rate increases.
How do I send an SMS through Jentic with the Plivo API?
Search for 'send an SMS message' in Jentic to find the Plivo Message endpoint. Load the operation schema, then execute with src (your Plivo number), dst (recipient number), and text (message body). Install with pip install jentic and use the search-load-execute flow. Jentic handles Basic auth injection automatically.
Does Plivo support sending to international numbers?
Yes. Plivo supports messaging to 200+ countries. Include the full E.164 formatted number (e.g., +44xxxxxxxxxx for UK) in the dst field. Pricing varies by destination country and can be checked on Plivo's rate cards. No additional configuration is needed for international sends beyond using an enabled source number.
Can I check delivery status for sent messages?
Yes. After sending, use GET /Message/{message_uuid} to retrieve the current delivery status. The response includes status values like queued, sent, delivered, failed, or undelivered, along with timestamps and any error codes. You can also configure a delivery callback URL in the send request for real-time status webhooks.
GET STARTED