> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Plivo

The Plivo connector lets your AI agent work with Plivo. Scalekit handles authentication for every call, so your agent never handles credentials. It comes with 43 tools.

**Authentication:** Auth ID and Auth Token
**Categories:** Communication
**Tools:** 43: 22 read, 14 write, 7 destructive
**Users sign in with:** Username and password
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=PLIVO)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Plivo connection

   In **AgentKit > Connections**, create a Plivo connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'plivo_account_get',
  toolInput: {
    auth_id: '<auth_id>',
  },
  connector: 'plivo',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="plivo_account_get",
    tool_input={
        "auth_id": "<auth_id>",
    },
    connection_name="plivo",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `plivo_account_get`

Get Account · Read-only

Get your Plivo account details and credit balance.
Returns auth_id, name, account_type, billing_mode, cash_credits, auto_recharge, address, city, state and timezone.
Use plivo_account_get to check the balance before large sends.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `auth_id` (`string`, required): Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX

Example input: `{"auth_id":"<auth_id>"}`

### `plivo_application_get`

Get Application · Read-only

Get one Plivo application.
Returns app_id, app_name, answer_url, answer_method, hangup_url, fallback_answer_url, message_url, sip_uri and default flags.
Use plivo_application_get for one application. Use plivo_applications_list to browse.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `app_id` (`string`, required): ID of the application. Example: 77506472664956353
- `auth_id` (`string`, required): Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX

Example input: `{"app_id":"<app_id>","auth_id":"<auth_id>"}`

### `plivo_applications_list`

List Applications · Read-only

List the Plivo XML applications (answer, hangup and message URLs) on your account.
Returns meta and objects with app_id, app_name, answer_url, hangup_url, message_url and default flags.
Use plivo_applications_list to find an app_id to attach to numbers.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `auth_id` (`string`, required): Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX
- `app_name` (`string`, optional): Only the application with this name. Example: support-ivr
- `limit` (`integer`, optional): Results per page, 1 to 20. Defaults to 20. Example: 20
- `offset` (`integer`, optional): Number of results to skip, for paging. Example: 0
- `subaccount` (`string`, optional): Only results for this subaccount Auth ID. Example: SAXXXXXXXXXXXXXXXXXX

Example input: `{"auth_id":"<auth_id>"}`

### `plivo_call_get`

Get Call · Read-only

Get the detail record of one completed Plivo call.
Returns call_uuid, from_number, to_number, call_direction, answer_time, end_time, call_duration, bill_duration, hangup_cause_name and total_amount.
Use plivo_call_get after a call ends. Use plivo_live_call_get while it is in progress.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `auth_id` (`string`, required): Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX
- `call_uuid` (`string`, required): UUID of the call. Example: eba53b9e-8fbd-45c1-9444-696d2172fbc8

Example input: `{"auth_id":"<auth_id>","call_uuid":"<call_uuid>"}`

### `plivo_calls_list`

List Calls · Read-only

List completed calls (call detail records) in your Plivo account.
Returns meta and objects with call_uuid, from_number, to_number, call_direction, call_duration, bill_duration, hangup_cause_name and total_amount.
Use plivo_calls_list for call history. Use plivo_live_calls_list for calls in progress.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `auth_id` (`string`, required): Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX
- `bill_duration_gt` (`integer`, optional): Only calls billed for more than this many seconds. Example: 60
- `call_direction` (`string`, optional): Only inbound or outbound calls. Example: outbound. One of: `inbound`, `outbound`.
- `end_time_gte` (`string`, optional): Only calls that ended at or after this UTC time, YYYY-MM-DD HH:MM[:ss]. Example: 2026-11-01 00:00
- `end_time_lte` (`string`, optional): Only calls that ended at or before this UTC time, YYYY-MM-DD HH:MM[:ss]. Example: 2026-11-02 00:00
- `from_number` (`string`, optional): Only calls from this number. Example: 14151234567
- `hangup_cause_code` (`integer`, optional): Only calls with this hangup cause code. Example: 4000
- `hangup_source` (`string`, optional): Only calls hung up by this side. Example: customer. One of: `customer`, `carrier`, `zentrunk`.
- `limit` (`integer`, optional): Results per page, 1 to 20. Defaults to 20. Example: 20
- `offset` (`integer`, optional): Number of results to skip, for paging. Example: 0
- `to_number` (`string`, optional): Only calls to this number. Example: 14157654321

Example input: `{"auth_id":"<auth_id>"}`

### `plivo_conference_get`

Get Conference · Read-only

Get a running Plivo conference and its members.
Returns conference_name, conference_run_time, conference_member_count and members with member_id, call_uuid, muted and deaf.
Use plivo_conference_get to see who is in a conference.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `auth_id` (`string`, required): Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX
- `conference_name` (`string`, required): Name of the conference. Example: standup

Example input: `{"auth_id":"<auth_id>","conference_name":"<conference_name>"}`

### `plivo_conferences_list`

List Conferences · Read-only

List the conferences currently running on your Plivo account.
Returns conferences, a list of conference names.
Use plivo_conferences_list to find live conferences. Use plivo_conference_get for members.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `auth_id` (`string`, required): Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX

Example input: `{"auth_id":"<auth_id>"}`

### `plivo_live_call_get`

Get Live Call · Read-only

Get the current state of a Plivo call that is in progress.
Returns call_uuid, direction, from, to, call_status, caller_name and session_start.
Use plivo_live_call_get during a call. Use plivo_call_get once it has ended.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `auth_id` (`string`, required): Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX
- `call_uuid` (`string`, required): UUID of the live call. Example: eba53b9e-8fbd-45c1-9444-696d2172fbc8

Example input: `{"auth_id":"<auth_id>","call_uuid":"<call_uuid>"}`

### `plivo_live_calls_list`

List Live Calls · Read-only

List the calls currently in progress on your Plivo account.
Returns calls, a list of call_uuid values.
Use plivo_live_calls_list to find active calls. Use plivo_live_call_get for one call's details.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `auth_id` (`string`, required): Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX

Example input: `{"auth_id":"<auth_id>"}`

### `plivo_message_get`

Get Message · Read-only

Get one Plivo message detail record by its UUID.
Returns message_uuid, from_number, to_number, message_direction, message_state, message_type, units, total_amount, error_code and message_time.
Use plivo_message_get to check delivery of a message sent with plivo_message_send.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `auth_id` (`string`, required): Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX
- `message_uuid` (`string`, required): UUID of the message, from plivo_message_send or plivo_messages_list. Example: b48d95dc-e3ac-11eb-a9c2-0242ac110005

Example input: `{"auth_id":"<auth_id>","message_uuid":"<message_uuid>"}`

### `plivo_message_media_list`

List MMS Media · Read-only

List the media files attached to a Plivo MMS message.
Returns objects with media_id, content_type, size and media_url.
Use plivo_message_media_list to read pictures or files received by MMS.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `auth_id` (`string`, required): Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX
- `message_uuid` (`string`, required): UUID of the MMS message. Example: b48d95dc-e3ac-11eb-a9c2-0242ac110005

Example input: `{"auth_id":"<auth_id>","message_uuid":"<message_uuid>"}`

### `plivo_messages_list`

List Messages · Read-only

List message detail records (sent and received SMS, MMS and WhatsApp) in your Plivo account, newest first.
Returns meta (limit, offset, total_count) and objects with message_uuid, from_number, to_number, message_state, message_type, error_code and charges.
Use plivo_messages_list to find messages by state, direction or time. Use plivo_message_get for one message.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `auth_id` (`string`, required): Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX
- `error_code` (`integer`, optional): Only messages with this Plivo error code. Example: 30
- `limit` (`integer`, optional): Results per page, 1 to 20. Defaults to 20. Example: 20
- `message_direction` (`string`, optional): Only inbound or outbound messages. Example: outbound. One of: `inbound`, `outbound`.
- `message_state` (`string`, optional): Only messages in this state. Example: delivered. One of: `queued`, `sent`, `delivered`, `undelivered`, `failed`, `received`, `read`.
- `message_time_gt` (`string`, optional): Only messages after this UTC time, yyyy-MM-dd HH:mm:ss. Example: 2026-11-01 00:00:00
- `message_time_lt` (`string`, optional): Only messages before this UTC time, yyyy-MM-dd HH:mm:ss. Example: 2026-11-02 00:00:00
- `message_type` (`string`, optional): Only this message type. Example: sms. One of: `sms`, `mms`, `whatsapp`.
- `offset` (`integer`, optional): Number of results to skip, for paging. Example: 0
- `powerpack_id` (`string`, optional): Only messages sent through this Powerpack. Example: d7a8e9f0-1b2c-4d3e-8f9a-0b1c2d3e4f5a
- `subaccount` (`string`, optional): Only results for this subaccount Auth ID. Example: SAXXXXXXXXXXXXXXXXXX

Example input: `{"auth_id":"<auth_id>"}`

### `plivo_number_get`

Get Account Number · Read-only

Get one phone number rented on your Plivo account.
Returns number, alias, application, number_type, capabilities, monthly_rental_rate, renewal_date and compliance and 10DLC details.
Use plivo_number_get for one number. Use plivo_numbers_list to browse.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `auth_id` (`string`, required): Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX
- `number` (`string`, required): The rented number in E.164 format without +. Example: 14155551234

Example input: `{"auth_id":"<auth_id>","number":"<number>"}`

### `plivo_numbers_list`

List Account Numbers · Read-only

List the phone numbers rented on your Plivo account.
Returns meta and objects with number, alias, application, number_type, voice_enabled, sms_enabled, mms_enabled, renewal_date and 10DLC status.
Use plivo_numbers_list to find your sender numbers. Use plivo_number_get for one number.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `auth_id` (`string`, required): Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX
- `alias` (`string`, optional): Only the number with this exact alias. Example: support-line
- `limit` (`integer`, optional): Results per page, 1 to 20. Defaults to 20. Example: 20
- `number_startswith` (`string`, optional): Only numbers starting with these digits. Example: 1415
- `offset` (`integer`, optional): Number of results to skip, for paging. Example: 0
- `services` (`string`, optional): Only numbers with these capabilities, for example sms or voice,sms. Example: sms
- `subaccount` (`string`, optional): Only results for this subaccount Auth ID. Example: SAXXXXXXXXXXXXXXXXXX
- `tendlc_registration_status` (`string`, optional): Only numbers with this US 10DLC registration status. Example: registered. One of: `unregistered`, `in_progress`, `registered`.
- `type` (`string`, optional): Only this number type. Example: local. One of: `local`, `mobile`, `fixed`, `national`, `tollfree`.

Example input: `{"auth_id":"<auth_id>"}`

### `plivo_phone_numbers_search`

Search Phone Numbers · Read-only

Search Plivo's inventory for phone numbers you can rent in a country.
Returns meta and objects with number, type, region, voice_enabled, sms_enabled, mms_enabled, monthly_rental_rate and setup_rate.
Use plivo_phone_numbers_search before plivo_phone_number_buy. Use plivo_numbers_list for numbers you already rent.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `auth_id` (`string`, required): Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX
- `country_iso` (`string`, required): ISO 3166 alpha-2 country code. Example: US
- `city` (`string`, optional): City name (local numbers only). Example: San Francisco
- `limit` (`integer`, optional): Results per page, 1 to 20. Defaults to 20. Example: 20
- `npanxx` (`integer`, optional): US and Canada only: six-digit NPA-NXX prefix. Example: 415555
- `offset` (`integer`, optional): Number of results to skip, for paging. Example: 0
- `pattern` (`string`, optional): Digits the number starts with after the country code, for example 415. Example: 415
- `region` (`string`, optional): Region name (fixed numbers only), for example Frankfurt. Example: Frankfurt
- `services` (`string`, optional): Required capabilities. Example: voice,sms. One of: `voice`, `sms`, `mms`, `voice,sms`, `voice,sms,mms`.
- `type` (`string`, optional): Number type. Example: local. One of: `tollfree`, `local`, `mobile`, `national`, `fixed`.

Example input: `{"auth_id":"<auth_id>","country_iso":"<country_iso>"}`

### `plivo_powerpack_get`

Get Powerpack · Read-only

Get one Plivo Powerpack and its settings.
Returns uuid, name, sticky_sender, local_connect, application_type, application_id, number_priority and number_pool.
Use plivo_powerpack_get for one Powerpack. Use plivo_powerpacks_list to browse.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `auth_id` (`string`, required): Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX
- `powerpack_uuid` (`string`, required): UUID of the Powerpack. Example: d7a8e9f0-1b2c-4d3e-8f9a-0b1c2d3e4f5a

Example input: `{"auth_id":"<auth_id>","powerpack_uuid":"<powerpack_uuid>"}`

### `plivo_powerpacks_list`

List Powerpacks · Read-only

List the Powerpacks (sender number pools) in your Plivo account.
Returns meta and objects with uuid, name, sticky_sender, local_connect and number_pool.
Use plivo_powerpacks_list to find a powerpack_uuid for plivo_message_send.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `auth_id` (`string`, required): Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX
- `limit` (`integer`, optional): Results per page, 1 to 20. Defaults to 20. Example: 20
- `offset` (`integer`, optional): Number of results to skip, for paging. Example: 0

Example input: `{"auth_id":"<auth_id>"}`

### `plivo_queued_calls_list`

List Queued Calls · Read-only

List outbound calls that are queued and not yet dialled on your Plivo account.
Returns calls, a list of call_uuid values.
Use plivo_queued_calls_list to see calls waiting for capacity.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `auth_id` (`string`, required): Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX

Example input: `{"auth_id":"<auth_id>"}`

### `plivo_recording_get`

Get Recording · Read-only

Get one Plivo recording's details and download URL.
Returns recording_id, call_uuid, recording_url, recording_format, recording_type, recording_duration_ms and add_time.
Use plivo_recording_get to get the recording_url of a recording.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `auth_id` (`string`, required): Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX
- `recording_id` (`string`, required): ID of the recording. Example: c2186400-1c8c-11e4-a664-0026b945b52x

Example input: `{"auth_id":"<auth_id>","recording_id":"<recording_id>"}`

### `plivo_recordings_list`

List Recordings · Read-only

List call and conference recordings in your Plivo account. Without a time filter Plivo searches the last 7 days.
Returns meta and objects with recording_id, call_uuid, conference_name, recording_url, recording_duration_ms and add_time.
Use plivo_recordings_list to find recordings of a call. Use plivo_recording_get for one recording.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `auth_id` (`string`, required): Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX
- `add_time_gte` (`string`, optional): Only recordings created at or after this UTC time, YYYY-MM-DD HH:MM. The window can be at most 30 days. Example: 2026-11-01 00:00
- `add_time_lte` (`string`, optional): Only recordings created at or before this UTC time, YYYY-MM-DD HH:MM. Example: 2026-11-02 00:00
- `call_uuid` (`string`, optional): Only recordings of this call. Example: eba53b9e-8fbd-45c1-9444-696d2172fbc8
- `conference_name` (`string`, optional): Only recordings of this conference. Example: standup
- `from_number` (`string`, optional): Only recordings of calls from this number or SIP endpoint. Example: 14151234567
- `limit` (`integer`, optional): Results per page, 1 to 20. Defaults to 20. Example: 20
- `offset` (`integer`, optional): Number of results to skip, for paging. Example: 0
- `subaccount` (`string`, optional): Only results for this subaccount Auth ID. Example: SAXXXXXXXXXXXXXXXXXX
- `to_number` (`string`, optional): Only recordings of calls to this number or SIP endpoint. Example: 14157654321

Example input: `{"auth_id":"<auth_id>"}`

### `plivo_verify_session_get`

Get Verification Session · Read-only

Get a Plivo Verify session's status and delivery attempts.
Returns session_uuid, recipient, channel, status (in-progress, verified, expired), attempt_details and charges.
Use plivo_verify_session_get to see whether a user completed verification.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `auth_id` (`string`, required): Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX
- `session_uuid` (`string`, required): UUID of the session. Example: 4124e518-a8c9-4feb-8cff-d86636ba9234

Example input: `{"auth_id":"<auth_id>","session_uuid":"<session_uuid>"}`

### `plivo_verify_sessions_list`

List Verification Sessions · Read-only

List Plivo Verify sessions, filtered by status, recipient, application or time.
Returns meta and sessions with session_uuid, recipient, channel, status and created_at.
Use plivo_verify_sessions_list for verification history. Use plivo_verify_session_get for one session.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `auth_id` (`string`, required): Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX
- `app_uuid` (`string`, optional): Only sessions of this Verify application. Example: b6a4fe0e-2b4f-4c55-9a3c-1f5e3d7c9b2a
- `limit` (`integer`, optional): Results per page, 1 to 20. Defaults to 20. Example: 20
- `offset` (`integer`, optional): Number of results to skip, for paging. Example: 0
- `recipient` (`string`, optional): Only sessions for this phone number. Example: 14157654321
- `session_time_gte` (`string`, optional): Only sessions started at or after this UTC time, YYYY-MM-DD HH:MM. Example: 2026-11-01 00:00
- `session_time_lte` (`string`, optional): Only sessions started at or before this UTC time, YYYY-MM-DD HH:MM. Example: 2026-11-02 00:00
- `status` (`string`, optional): Only sessions in this state. Example: verified. One of: `in-progress`, `verified`, `expired`.
- `subaccount` (`string`, optional): Only results for this subaccount Auth ID. Example: SAXXXXXXXXXXXXXXXXXX

Example input: `{"auth_id":"<auth_id>"}`

### `plivo_account_update`

Update Account · Write

Update your Plivo account's name, address, city, state or timezone.
Returns api_id and message changed.
Use plivo_account_update to change account profile details.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `auth_id` (`string`, required): Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX
- `address` (`string`, optional): Street address. Example: 1 Market St
- `city` (`string`, optional): City. Example: San Francisco
- `name` (`string`, optional): Account name. Example: Acme Inc
- `state` (`string`, optional): State or province. Example: CA
- `timezone` (`string`, optional): IANA time zone, for example America/Los_Angeles. Example: America/Los_Angeles

Example input: `{"auth_id":"<auth_id>"}`

### `plivo_application_create`

Create Application · Write

Create a Plivo application that tells Plivo which URLs to call for incoming calls, hangups and incoming messages on attached numbers.
Returns app_id and api_id.
Use plivo_application_create, then attach numbers with plivo_number_update.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `answer_url` (`string`, required): URL that returns Plivo XML for incoming calls. Example: https://example.com/plivo/answer.xml
- `app_name` (`string`, required): Unique name for the application. Example: support-ivr
- `auth_id` (`string`, required): Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX
- `answer_method` (`string`, optional): HTTP method Plivo uses to call answer_url. Defaults to POST. Example: POST. One of: `GET`, `POST`.
- `default_endpoint_app` (`boolean`, optional): Make this the default application for new SIP endpoints. Example: false
- `default_number_app` (`boolean`, optional): Make this the default application for new numbers. Example: false
- `fallback_answer_url` (`string`, optional): URL used if answer_url fails. Example: https://example.com/plivo/fallback.xml
- `hangup_url` (`string`, optional): URL notified when a call ends. Example: https://example.com/plivo/hangup
- `log_incoming_messages` (`boolean`, optional): Log the content of incoming messages. Defaults to true. Example: true
- `message_method` (`string`, optional): HTTP method Plivo uses to call message_url. Defaults to POST. Example: POST. One of: `GET`, `POST`.
- `message_url` (`string`, optional): URL that receives incoming SMS, MMS and WhatsApp messages. Example: https://example.com/plivo/inbound-message

Example input: `{"answer_url":"<answer_url>","app_name":"<app_name>","auth_id":"<auth_id>"}`

### `plivo_application_update`

Update Application · Write

Change a Plivo application's answer, hangup, fallback or message URLs and default flags.
Returns api_id and message changed.
Use plivo_application_update to point numbers at new webhook URLs.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `app_id` (`string`, required): ID of the application. Example: 77506472664956353
- `auth_id` (`string`, required): Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX
- `answer_method` (`string`, optional): HTTP method Plivo uses to call answer_url. Defaults to POST. Example: POST. One of: `GET`, `POST`.
- `answer_url` (`string`, optional): URL that returns Plivo XML for incoming calls. Example: https://example.com/plivo/answer.xml
- `default_endpoint_app` (`boolean`, optional): Make this the default application for new SIP endpoints. Example: false
- `default_number_app` (`boolean`, optional): Make this the default application for new numbers. Example: false
- `fallback_answer_url` (`string`, optional): URL used if answer_url fails. Example: https://example.com/plivo/fallback.xml
- `hangup_url` (`string`, optional): URL notified when a call ends. Example: https://example.com/plivo/hangup
- `log_incoming_messages` (`boolean`, optional): Log the content of incoming messages. Example: true
- `message_method` (`string`, optional): HTTP method Plivo uses to call message_url. Defaults to POST. Example: POST. One of: `GET`, `POST`.
- `message_url` (`string`, optional): URL that receives incoming messages. Example: https://example.com/plivo/inbound-message

Example input: `{"app_id":"<app_id>","auth_id":"<auth_id>"}`

### `plivo_call_create`

Make Call · Write

Place an outbound voice call from a Plivo number; when answered, Plivo fetches call instructions (Plivo XML) from your answer_url.
Returns request_uuid and api_id; the call_uuid arrives in your answer and hangup callbacks.
Use plivo_call_create to start a call. Use plivo_live_calls_list or plivo_call_get to follow it, and plivo_request_cancel to cancel it before it is answered.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `answer_url` (`string`, required): URL Plivo calls when the call is answered. It must return Plivo XML that tells Plivo what to do (for example  or ). Example: https://example.com/plivo/answer.xml
- `auth_id` (`string`, required): Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX
- `from` (`string`, required): Caller ID: a Plivo number in E.164 format without +. Example: 14151234567
- `to` (`string`, required): Destination phone number in E.164 format or a SIP URI. Separate several destinations with <. Example: 14157654321
- `answer_method` (`string`, optional): HTTP method Plivo uses to call answer_url. Defaults to POST. Example: POST. One of: `GET`, `POST`.
- `caller_name` (`string`, optional): Caller name shown on SIP endpoints, up to 50 characters. Example: Acme Support
- `fallback_url` (`string`, optional): URL used if answer_url fails. Example: https://example.com/plivo/fallback.xml
- `hangup_url` (`string`, optional): URL notified when the call ends, with duration and hangup cause. Example: https://example.com/plivo/hangup
- `machine_detection` (`string`, optional): Answering-machine detection: true to report it to machine_detection_url, hangup to hang up on machines. Example: true. One of: `true`, `hangup`.
- `machine_detection_url` (`string`, optional): URL that receives the asynchronous machine-detection result. Example: https://example.com/plivo/amd
- `ring_timeout` (`integer`, optional): Seconds to ring before giving up. Example: 30
- `ring_url` (`string`, optional): URL notified when the call starts ringing. Example: https://example.com/plivo/ring
- `send_digits` (`string`, optional): DTMF digits to send once connected; w waits 0.5 s and W waits 1 s. Example: ww1234#
- `sip_headers` (`string`, optional): Custom SIP headers as key=value pairs separated by commas; sent with an X-PH- prefix. Example: ticket=1234,priority=high
- `time_limit` (`integer`, optional): Maximum call length in seconds. Defaults to 14400 (4 hours). Example: 600

Example input: `{"answer_url":"<answer_url>","auth_id":"<auth_id>","from":"<from>","to":"<to>"}`

### `plivo_call_dtmf_send`

Send DTMF · Write

Send DTMF tones (keypad digits) on a live Plivo call, for example to navigate a phone menu.
Returns api_id and message digits sent.
Use plivo_call_dtmf_send while a call is in progress.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `auth_id` (`string`, required): Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX
- `call_uuid` (`string`, required): UUID of the live call. Example: eba53b9e-8fbd-45c1-9444-696d2172fbc8
- `digits` (`string`, required): Digits to send: 0-9, *, #, and w (0.5 s pause) or W (1 s pause). Example: 1w2w3#
- `leg` (`string`, optional): Leg to send the tones on: aleg (default) or bleg. Example: aleg. One of: `aleg`, `bleg`.

Example input: `{"auth_id":"<auth_id>","call_uuid":"<call_uuid>","digits":"<digits>"}`

### `plivo_call_transfer`

Transfer Call · Write

Redirect one or both legs of a live Plivo call to new Plivo XML instructions, for example to move a caller to an agent.
Returns api_id and message call transferred.
Use plivo_call_transfer to change what a live call does.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `auth_id` (`string`, required): Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX
- `call_uuid` (`string`, required): UUID of the live call. Example: eba53b9e-8fbd-45c1-9444-696d2172fbc8
- `aleg_method` (`string`, optional): HTTP method Plivo uses to call aleg_url. Defaults to POST. Example: POST. One of: `GET`, `POST`.
- `aleg_url` (`string`, optional): URL returning Plivo XML for the A leg. Required when legs is aleg or both. Example: https://example.com/plivo/transfer.xml
- `bleg_method` (`string`, optional): HTTP method Plivo uses to call bleg_url. Defaults to POST. Example: POST. One of: `GET`, `POST`.
- `bleg_url` (`string`, optional): URL returning Plivo XML for the B leg. Required when legs is bleg or both. Example: https://example.com/plivo/transfer-b.xml
- `legs` (`string`, optional): Which leg to transfer: aleg (the caller), bleg (the dialled party) or both. Example: aleg. One of: `aleg`, `bleg`, `both`.

Example input: `{"auth_id":"<auth_id>","call_uuid":"<call_uuid>"}`

### `plivo_message_send`

Send Message · Write

Send an SMS, MMS or WhatsApp message (text, media, template, interactive or location) from a Plivo number, short code, sender ID or Powerpack.
Returns message_uuid (a list, one per destination) and api_id.
Use plivo_message_send for every outbound message. Use plivo_message_get or plivo_messages_list to check delivery state.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `auth_id` (`string`, required): Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX
- `dst` (`string`, required): Destination phone number in E.164 format. For several SMS recipients, separate numbers with < (for example 14156667777<14157778888). Example: 14157654321
- `interactive` (`object`, optional): WhatsApp only: an interactive message (reply buttons, list or call-to-action URL button) in WhatsApp Cloud API format. Example: {"type": "button", "body": {"text": "Confirm your order?"}, "action": {"buttons": [{"title": "Yes", "id": "yes"}, {"title": "No", "id": "no"}]}}
- `location` (`object`, optional): WhatsApp only: a location pin with latitude, longitude, name and address. Example: {"latitude": "37.7749", "longitude": "-122.4194", "name": "Store", "address": "1 Market St, San Francisco"}
- `log` (`string`, optional): Logging of content and numbers: true (default), false, content_only (hide numbers) or number_only (hide content). Example: true. One of: `true`, `false`, `content_only`, `number_only`.
- `media_urls` (`array`, optional): Media URLs. MMS: up to 10 public URLs, under 5 MB in total. WhatsApp: a single media URL. Example: ["https://example.com/files/receipt.jpg"]
- `message_expiry` (`integer`, optional): Seconds the message may wait in Plivo's queue before it is dropped, 5 to 10799. Defaults to 10800 (3 hours). Example: 3600
- `method` (`string`, optional): HTTP method Plivo uses to call the status url. Defaults to POST. Example: POST. One of: `GET`, `POST`.
- `powerpack_uuid` (`string`, optional): Send from a Powerpack number pool instead of src (SMS and MMS). Example: d7a8e9f0-1b2c-4d3e-8f9a-0b1c2d3e4f5a
- `src` (`string`, optional): Sender: a Plivo number, short code or alphanumeric sender ID; for WhatsApp, your WhatsApp Business number. Use either src or powerpack_uuid. Example: 14151234567
- `template` (`object`, optional): WhatsApp only: an approved template to send, with name, language and optional components carrying the parameter values. Needed to start a WhatsApp conversation outside the 24-hour window. Example: {"name": "order_update", "language": "en_US", "components": [{"type": "body", "parameters": [{"type": "text", "text": "1234"}]}]}
- `text` (`string`, optional): Message text. SMS: up to 1600 GSM or 737 Unicode characters. WhatsApp free-form: up to 4096 characters. Optional caption for MMS. Example: Your order 1234 has shipped.
- `trackable` (`boolean`, optional): Set true for messages with a trackable action such as a one-time code, to report conversion. Defaults to false. Example: false
- `type` (`string`, optional): Message type: sms (default), mms or whatsapp. Example: sms. One of: `sms`, `mms`, `whatsapp`.
- `url` (`string`, optional): Webhook URL that receives delivery status updates for this message. Example: https://example.com/plivo/status

Example input: `{"auth_id":"<auth_id>","dst":"<dst>"}`

### `plivo_number_lookup`

Look Up Phone Number · Write

Look up a phone number's carrier, number type (mobile, fixed, voip, toll-free), country and E.164 format with the Plivo Lookup API. Each lookup is charged.
Returns phone_number, country, format (e164, national, international), carrier (name, type, mobile_country_code, mobile_network_code, ported) and resource_uri.
Use plivo_number_lookup to validate a number or check if it is mobile before sending SMS.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `number` (`string`, required): Phone number in E.164 format with leading +. Example: +14151234567

Example input: `{"number":"<number>"}`

### `plivo_number_update`

Update Account Number · Write

Change a rented Plivo number's application, alias, subaccount, CNAM or compliance application.
Returns api_id and message changed.
Use plivo_number_update to route a number to an application or rename it.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `auth_id` (`string`, required): Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX
- `number` (`string`, required): The rented number in E.164 format without +. Example: 14155551234
- `alias` (`string`, optional): Your own name for the number. Example: support-line
- `app_id` (`string`, optional): Application that handles inbound calls and messages for this number. Example: 77506472664956353
- `cnam` (`string`, optional): US only: caller ID name shown on outbound calls. Example: ACME SUPPORT
- `cnam_lookup` (`string`, optional): US only: enable or disable caller-name lookup on inbound calls. Example: enabled. One of: `enabled`, `disabled`.
- `compliance_application_id` (`string`, optional): UUID of an accepted compliance application to link. Example: a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d
- `subaccount` (`string`, optional): Auth ID of the subaccount to move the number to. Example: SAXXXXXXXXXXXXXXXXXX

Example input: `{"auth_id":"<auth_id>","number":"<number>"}`

### `plivo_phone_number_buy`

Buy Phone Number · Write

Rent a phone number from Plivo's inventory. This charges your account the setup fee and monthly rental.
Returns numbers with the rented number and its status, plus api_id.
Use plivo_phone_number_buy with a number from plivo_phone_numbers_search. Some countries need an accepted compliance application first.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `auth_id` (`string`, required): Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX
- `number` (`string`, required): The number to rent, from plivo_phone_numbers_search. Example: 14155551234
- `app_id` (`string`, optional): Application to attach for inbound calls and messages. Defaults to your default number application. Example: 77506472664956353
- `cnam_lookup` (`string`, optional): US only: enable or disable caller-name lookup on inbound calls. Example: enabled. One of: `enabled`, `disabled`.
- `compliance_application_id` (`string`, optional): UUID of an accepted compliance application for this country and number type. Example: a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d
- `subaccount` (`string`, optional): Auth ID of a subaccount to give the number to. Example: SAXXXXXXXXXXXXXXXXXX

Example input: `{"auth_id":"<auth_id>","number":"<number>"}`

### `plivo_powerpack_create`

Create Powerpack · Write

Create a Plivo Powerpack, a pool of sender numbers that Plivo picks from per destination.
Returns the new Powerpack with its uuid.
Use plivo_powerpack_create, then add numbers to the pool in the Plivo console, and send with powerpack_uuid.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `auth_id` (`string`, required): Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX
- `name` (`string`, required): Unique name for the Powerpack. Example: marketing-pool
- `application_id` (`string`, optional): ID of the application or PHLO that handles inbound messages to pool numbers. Example: 77506472664956353
- `application_type` (`string`, optional): Type of application handling inbound messages: xml or phlo. Example: xml. One of: `xml`, `phlo`.
- `local_connect` (`boolean`, optional): Prefer a sender number local to the recipient. Defaults to true. Example: true
- `number_priority` (`array`, optional): Per-country order of number types to send from, for example [{"country_iso": "US", "priority": {"priority1": "shortcode", "priority2": "tollfree", "priority3": "longcode"}}]. Example: [{"country_iso": "US", "priority": {"priority1": "tollfree", "priority2": "longcode"}}]
- `sticky_sender` (`boolean`, optional): Keep using the same sender number for each recipient. Defaults to true. Example: true

Example input: `{"auth_id":"<auth_id>","name":"<name>"}`

### `plivo_powerpack_update`

Update Powerpack · Write

Change a Plivo Powerpack's name, sticky sender, local connect, inbound application or number priority.
Returns the updated Powerpack.
Use plivo_powerpack_update to change pool behaviour.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `auth_id` (`string`, required): Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX
- `powerpack_uuid` (`string`, required): UUID of the Powerpack. Example: d7a8e9f0-1b2c-4d3e-8f9a-0b1c2d3e4f5a
- `application_id` (`string`, optional): Application or PHLO ID for inbound messages. Example: 77506472664956353
- `application_type` (`string`, optional): xml or phlo. Example: xml. One of: `xml`, `phlo`.
- `local_connect` (`boolean`, optional): Prefer a sender number local to the recipient. Example: false
- `name` (`string`, optional): New name. Example: marketing-pool-2
- `number_priority` (`array`, optional): Per-country order of number types to send from. Example: [{"country_iso": "US", "priority": {"priority1": "tollfree", "priority2": "longcode"}}]
- `sticky_sender` (`boolean`, optional): Keep using the same sender number for each recipient. Example: true

Example input: `{"auth_id":"<auth_id>","powerpack_uuid":"<powerpack_uuid>"}`

### `plivo_verify_session_create`

Send Verification Code · Write

Start a Plivo Verify session that sends a one-time code to a phone number by SMS or voice.
Returns session_uuid and api_id.
Use plivo_verify_session_create to begin phone verification. Use plivo_verify_session_validate with the code the user enters.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `auth_id` (`string`, required): Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX
- `recipient` (`string`, required): Phone number to verify, in E.164 format. Example: 14157654321
- `app_hash` (`string`, optional): Android app hash for the SMS Retriever API, so the app can read the code automatically. Example: FA+9qCX9VSu
- `app_uuid` (`string`, optional): UUID of the Verify application whose settings to use. Defaults to your default Verify application. Example: b6a4fe0e-2b4f-4c55-9a3c-1f5e3d7c9b2a
- `brand_name` (`string`, optional): Brand name that replaces ${brand_name} in the message template. Example: Acme
- `channel` (`string`, optional): How to send the code: sms (default) or voice. Example: sms. One of: `sms`, `voice`.
- `code_length` (`integer`, optional): Number of digits in the code, 4 to 8. Example: 6
- `locale` (`string`, optional): Language of the message, for example en, en_US, es or fr_FR. Defaults to en. Example: en_US
- `method` (`string`, optional): HTTP method Plivo uses to call the status url. Defaults to POST. Example: POST. One of: `GET`, `POST`.
- `url` (`string`, optional): Webhook URL that receives session status updates. Example: https://example.com/plivo/verify

Example input: `{"auth_id":"<auth_id>","recipient":"<recipient>"}`

### `plivo_verify_session_validate`

Check Verification Code · Write

Check the code a user entered against a Plivo Verify session.
Returns api_id and message session validated successfully, or an error for a wrong or expired code.
Use plivo_verify_session_validate after plivo_verify_session_create.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `auth_id` (`string`, required): Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX
- `otp` (`string`, required): The code the user entered. Example: 482910
- `session_uuid` (`string`, required): session_uuid returned by plivo_verify_session_create. Example: 4124e518-a8c9-4feb-8cff-d86636ba9234

Example input: `{"auth_id":"<auth_id>","otp":"<otp>","session_uuid":"<session_uuid>"}`

### `plivo_application_delete`

Delete Application · Destructive

Delete a Plivo application. Numbers and endpoints using it move to the default application.
Returns an empty 204 response on success.
Use plivo_application_delete to remove an unused application.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `app_id` (`string`, required): ID of the application. Example: 77506472664956353
- `auth_id` (`string`, required): Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX
- `cascade` (`boolean`, optional): Set true to also delete SIP endpoints that use this application. Defaults to true. Example: false
- `new_endpoint_application` (`string`, optional): ID of the application that endpoints move to when cascade is false. Example: 77506472664956354

Example input: `{"app_id":"<app_id>","auth_id":"<auth_id>"}`

### `plivo_call_hangup`

Hang Up Call · Destructive

Hang up a Plivo call that is in progress.
Returns an empty 204 response on success.
Use plivo_call_hangup to end a live call. Use plivo_request_cancel for a call that has not been answered yet.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `auth_id` (`string`, required): Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX
- `call_uuid` (`string`, required): UUID of the live call. Example: eba53b9e-8fbd-45c1-9444-696d2172fbc8

Example input: `{"auth_id":"<auth_id>","call_uuid":"<call_uuid>"}`

### `plivo_conference_hangup`

End Conference · Destructive

End a running Plivo conference and disconnect every member.
Returns an empty 204 response on success.
Use plivo_conference_hangup to close a conference.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `auth_id` (`string`, required): Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX
- `conference_name` (`string`, required): Name of the conference. Example: standup

Example input: `{"auth_id":"<auth_id>","conference_name":"<conference_name>"}`

### `plivo_number_unrent`

Unrent Number · Destructive

Release (unrent) a phone number from your Plivo account. The number stops working and may be rented by someone else.
Returns an empty 204 response on success.
Use plivo_number_unrent to stop paying for a number.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `auth_id` (`string`, required): Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX
- `number` (`string`, required): The rented number in E.164 format without +. Example: 14155551234

Example input: `{"auth_id":"<auth_id>","number":"<number>"}`

### `plivo_powerpack_delete`

Delete Powerpack · Destructive

Delete a Plivo Powerpack, optionally also releasing (unrenting) its numbers.
Returns api_id and a confirmation message.
Use plivo_powerpack_delete to remove a pool you no longer use.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `auth_id` (`string`, required): Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX
- `powerpack_uuid` (`string`, required): UUID of the Powerpack. Example: d7a8e9f0-1b2c-4d3e-8f9a-0b1c2d3e4f5a
- `unrent_numbers` (`boolean`, optional): Set true to also unrent every number in the pool. Defaults to false (numbers stay on your account). Example: false

Example input: `{"auth_id":"<auth_id>","powerpack_uuid":"<powerpack_uuid>"}`

### `plivo_recording_delete`

Delete Recording · Destructive

Permanently delete a Plivo recording and its audio file.
Returns an empty 204 response on success.
Use plivo_recording_delete for data-removal requests.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `auth_id` (`string`, required): Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX
- `recording_id` (`string`, required): ID of the recording. Example: c2186400-1c8c-11e4-a664-0026b945b52x

Example input: `{"auth_id":"<auth_id>","recording_id":"<recording_id>"}`

### `plivo_request_cancel`

Cancel Call Request · Destructive

Cancel an outbound Plivo call that has not been answered yet, using the request_uuid from plivo_call_create.
Returns an empty 204 response on success.
Use plivo_request_cancel before the call connects. Use plivo_call_hangup once it is live.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `auth_id` (`string`, required): Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX
- `request_uuid` (`string`, required): request_uuid returned by plivo_call_create. Example: 9834029e-58b6-11e1-b8b7-a5bd0e4e126f

Example input: `{"auth_id":"<auth_id>","request_uuid":"<request_uuid>"}`

## Related

Other Communication connectors ([all 132](/agentkit/connectors/?category=communication)):

- [Gmail](/agentkit/connectors/gmail/): Scalekit connector, OAuth, 48 tools
- [Slack](/agentkit/connectors/slack/): Scalekit connector, OAuth, 96 tools
- [Google Calendar](/agentkit/connectors/googlecalendar/): Scalekit connector, OAuth, 30 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
