Skip to main content
Plivo exposes REST APIs to send and manage SMS, MMS, and WhatsApp messages. All API requests use HTTPS.

Base URL


Authentication

All requests to the Messaging API are authenticated with BasicAuth using your Auth ID and Auth Token, which you can find on the Overview page of the Plivo console.

Content-Type

For POST requests, set the Content-Type header to application/json:
For media uploads, use multipart/form-data:

Timeouts and Proxies

Configure timeouts and proxy settings when initializing the client:

Pagination

Plivo uses offset-based pagination to list resources.

Parameters

integer
Number of results to return per page. Range: 1-20. Default: 20.
integer
Number of records to skip before returning results. Default: 0.

Example

If you have 100 results with limit=10 and offset=50, objects with indices 51-60 are returned.

Asynchronous Requests

For high-throughput scenarios, use asynchronous request patterns: