Plivo SMS API

Name: Plivo SMS API
Brand: Plivo SMS API
Availability: InStock

★ 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.

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.

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 | sh

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 instance

Jentic 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

GET STARTED

Start building with Plivo SMS API

Explore with Jentic

View OpenAPI Document

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.

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.

Plivo SMS API

Connect the Plivo SMS API to your agent

Capabilities

Start building with Plivo SMS API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs