Place One Call with Saperly

Ask your AI assistant to place one call using a Saperly phone number. Tell it which number to use, who to call, and what to say. Identify your number by the full number shown in your account or its last four digits. A message you add applies only to this call and replaces any saved call instructions.

Your AI

Use with your AI

For tasks with several steps, continue in the AI you already use.

CodexClaude CodeCursorWindsurfCline

View instructions

Use the Toolmu service to place one call with Saperly only when the user clearly asks. Before calling, check the Saperly phone-number list for the exact phone number or last four digits the user named. Use a number only when exactly one match is found. If no unique match is found, ask the user to choose one of the Saperly numbers visible in their account; do not place the call until they choose. Ask for the recipient’s full phone number, including its country code, if it is missing. If the user provides a message for the call, use it as the directions for this call only; it replaces saved call instructions. If no message is provided, leave the saved call instructions as they are. Place at most one call; do not retry after a timeout without a new request. Say whether Saperly accepted the request, and do not claim the person answered or the conversation happened unless confirmed. Stay within the spending limit the user agreed to.

Task:
Place one call from [the Saperly number shown in my account or its last four digits] to [the recipient’s phone number with country code]. Say [my short message]. Tell me whether Saperly accepted the request; don’t say the recipient answered unless confirmed.

Paste into your connected AI's conversation.

Connection guide

Up to 120 credits / call

The final charge is based on confirmed usage. Unused reserved credits return to your available balance.

Saperly

Place One Call with Saperly

You receive

See whether Saperly accepted the request for one call, along with any details it returned.

Start with your task

Place one call from [the Saperly number shown in my account or its last four digits] to [the recipient’s phone number with country code]. Say [my short message]. Tell me whether Saperly accepted the request; don’t say the recipient answered unless confirmed.

What to know

An accepted request only means Saperly received it; it does not mean the other person answered. A message you add replaces the number’s saved call instructions for this call only.

Inputs & outputs

Inspect the current inputs, availability, and maximum charge before starting.

Input schema

Input schema
Field / Path	Type	Requirement	Meaning
body`body`	`object`	Required	Required fields `fromNumberId, to`
E.164 destination`body.to`	`string`	Required	Required destination phone number in E.164 format, including + and the country calling code, such as +14155550123. Pattern `^\+[1-9]\d{6,14}$`
Owned caller resource ID`body.fromNumberId`	`string`	Required	Required nonempty ID of the Saperly phone-number resource you own to place the call from. Use its resource ID rather than its dialable phone number. Minimum length `1`
Instructions for this call`body.instructions`	`string`	Optional	Optional per-call system prompt of 1–10,000 characters. It overrides saved instructions for this call only. Minimum length `1` Maximum length `10000`

View raw JSON

{
  "type": "object",
  "required": [
    "body"
  ],
  "properties": {
    "body": {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "fromNumberId",
        "to"
      ],
      "~standard": {
        "vendor": "zod",
        "version": 1,
        "jsonSchema": {}
      },
      "properties": {
        "to": {
          "type": "string",
          "pattern": "^\\+[1-9]\\d{6,14}$",
          "description": "The destination phone number in E.164 format, e.g. \"+14155550123\"."
        },
        "fromNumberId": {
          "type": "string",
          "minLength": 1,
          "description": "The id of a phone number YOU OWN to place the call from (from /provision-numbers or /list-numbers)."
        },
        "instructions": {
          "type": "string",
          "maxLength": 10000,
          "minLength": 1,
          "description": "Optional per-call system prompt — overrides the number's saved persona instructions for THIS call only."
        }
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}

Result schema

Output fields have not been documented yet.

Additional notes

Before asking Saperly to place a call

Have ready the Saperly number you want to call from, the recipient’s phone number with its country code, and what you would like said, if anything. A message you add applies only to this call and replaces the number’s saved call instructions.

Read Saperly’s guide to placing a call.

Saperly accepting a call request does not confirm that the recipient answered.

Place One Call with Saperly

Place One Call with Saperly

You receive

Start with your task

What to know

Inputs & outputs

Input schema

Result schema

Before asking Saperly to place a call

Connect your AI assistant

Tell it what you need

Check the call request