RVM

Save an existing audio file as a reusable voicemail recording by fetching it from a public URL (the machine-surface equivalent of the app's upload button — binary uploads can't ride a tool call). TWILIO FORMAT RULE: the file must be MP3, WAV, GSM, µ-law or AIFF; m4a/aac/webm fail the drop with Twilio error 12300, so they're refused here. Voicemails must be 55 seconds or shorter. THIS MAKES AN OUTBOUND REQUEST FROM CHIRPLY'S SERVERS to whatever address is given, so everything in the URL — host, path, query string — is disclosed to whoever operates it. That is why it asks for confirmation.

Marked confirm: this operation is irreversible, reaches real people, or spends money. Holding a credential is itself the confirmation for API and MCP callers — call it only when you mean it. The in-app assistant refuses to run it without a human approving first.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/rvm.add_recording_from_url \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com"
  }'

Over MCP the same operation is the tool rvm_add_recording_from_url at https://app.chirply.io/api/mcp, same bearer token, same input.

Stop a voicemail campaign: any drop that hasn't gone out yet is skipped and the campaign is marked canceled. Voicemails already delivered can't be recalled, and a canceled campaign can't be resumed.

Marked confirm: this operation is irreversible, reaches real people, or spends money. Holding a credential is itself the confirmation for API and MCP callers — call it only when you mean it. The in-app assistant refuses to run it without a human approving first.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/rvm.cancel_campaign \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'

Over MCP the same operation is the tool rvm_cancel_campaign at https://app.chirply.io/api/mcp, same bearer token, same input.

Create and send a ringless-voicemail campaign to contacts and/or saved lists. THIS DROPS REAL VOICEMAILS: each recipient costs two outbound Twilio calls (a filter call plus the voicemail leg) billed to the account, and 'now' fans out immediately. Needs a saved recording (rvm.generate_recording or rvm.add_recording_from_url) and TWO DIFFERENT active numbers — a filter number and a from number. Do-not-contact is always enforced; quiet hours only when scheduled and explicitly asked for.

Marked confirm: this operation is irreversible, reaches real people, or spends money. Holding a credential is itself the confirmation for API and MCP callers — call it only when you mean it. The in-app assistant refuses to run it without a human approving first.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/rvm.create_campaign \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "audio_asset_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11",
    "filter_number_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11",
    "from_number_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'

Over MCP the same operation is the tool rvm_create_campaign at https://app.chirply.io/api/mcp, same bearer token, same input.

Drop a ringless voicemail to a single contact right now — the same one-click action as the contact page's 'Drop voicemail' dialog. THIS PLACES REAL CALLS and bills the account two Twilio legs. Needs a saved recording and two different active numbers. Do-not-contact is enforced before dialing.

Marked confirm: this operation is irreversible, reaches real people, or spends money. Holding a credential is itself the confirmation for API and MCP callers — call it only when you mean it. The in-app assistant refuses to run it without a human approving first.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/rvm.drop_to_contact \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "contact_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11",
    "audio_asset_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11",
    "filter_number_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11",
    "from_number_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'

Over MCP the same operation is the tool rvm_drop_to_contact at https://app.chirply.io/api/mcp, same bearer token, same input.

Turn a script into a reusable voicemail recording. Engine 'elevenlabs' synthesizes an MP3 right now through its OWN ElevenLabs account and SPENDS ITS TTS CREDITS; engine 'twilio' stores only the script and has Twilio speak it live at drop time (no synthesis charge, billed as part of the call). Scripts longer than about 55 spoken seconds are refused.

Marked confirm: this operation is irreversible, reaches real people, or spends money. Holding a credential is itself the confirmation for API and MCP callers — call it only when you mean it. The in-app assistant refuses to run it without a human approving first.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/rvm.generate_recording \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "example"
  }'

Over MCP the same operation is the tool rvm_generate_recording at https://app.chirply.io/api/mcp, same bearer token, same input.

Fetch one voicemail campaign with live per-status drop counts — how many are pending, in flight, dropped, failed or skipped.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/rvm.get_campaign \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'

Over MCP the same operation is the tool rvm_get_campaign at https://app.chirply.io/api/mcp, same bearer token, same input.

Fetch one saved voicemail recording by id, including its duration and (for text-to-speech recordings) the script and voice it speaks.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/rvm.get_recording \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'

Over MCP the same operation is the tool rvm_get_recording at https://app.chirply.io/api/mcp, same bearer token, same input.

List ringless-voicemail campaigns with their status and per-recipient tallies (dropped, failed, skipped), newest first.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/rvm.list_campaigns \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "limit": 25,
    "offset": 0
  }'

Over MCP the same operation is the tool rvm_list_campaigns at https://app.chirply.io/api/mcp, same bearer token, same input.

List the individual recipients of a voicemail campaign and what happened to each one — pending, filtering, dropping, dropped, failed (with the error) or skipped (e.g. do-not-contact).

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/rvm.list_drops \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "campaign_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'

Over MCP the same operation is the tool rvm_list_drops at https://app.chirply.io/api/mcp, same bearer token, same input.

List the saved voicemail recordings this account can drop — uploaded audio, in-app recordings, ElevenLabs-synthesized clips, and Twilio text-to-speech scripts. Newest first.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/rvm.list_recordings \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "limit": 25,
    "offset": 0
  }'

Over MCP the same operation is the tool rvm_list_recordings at https://app.chirply.io/api/mcp, same bearer token, same input.