Outbound Calls

Option 1: Call the API directly

The simplest way to place a call — send a POST request to the outbound call endpoint with a prompt and a phone number. Default settings:

language: en-US
voice: female
waitForCallEnd: false

curl -X POST https://api.pokulabs.com/calls \
  -H "Authorization: Bearer <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "You are a friendly voice assistant calling on behalf of Sarah to confirm a dentist appointment tomorrow at 2pm under the name Sarah Johnson.",
    "to": "+12155551234"
  }'

Waiting for the call to end

By default, Poku starts the call and returns an interactionId immediately. Use that ID with GET /interactions/:id/status to check whether the call has ended. Set waitForCallEnd to true when you want the HTTP request to stay open until the call finishes:

{
  "prompt": "...",
  "to": "+12155551234",
  "waitForCallEnd": true
}

Customizing voice and language

Pass the language parameter to specify the language for the call. For example, fr-FR for French. See the full list of supported languages.

{
  "prompt": "...",
  "to": "+12155551234",
  "language": "fr-FR"
}

Prompting best practices

The prompt is the only context the outbound agent has — write it as if briefing someone making the call on your behalf. Include:

Who they are calling as (“calling on behalf of…”)
The specific goal with enough detail to handle likely responses
Branching logic for common outcomes (available, unavailable, no answer)
A voicemail script if no one picks up

Example:

You are a friendly voice assistant calling on behalf of Joe to make a dinner reservation.

Make a reservation for 2 people on Friday at 7pm, under the name Joe Smith.
- If 7pm is available, confirm and ask if a note is needed for a special occasion.
- If 7pm is unavailable, ask what times are open and accept an alternative within one hour. Confirm the new time before ending the call.
- If no one answers, leave this voicemail: "Hi, this is a message on behalf of Joe — I'm hoping to make a dinner reservation for 2 on Friday at 7pm. Thank you."

Option 2: Use the Poku Skill

If you are using an agent such as Claude Code, OpenClaw, or Hermes, install the Poku skill. The Poku Skill will guide your agent to understand your objective, write the call prompt, and place the call automatically — no need to draft the prompt yourself. See Installation to get started.

Coming soon: Connect your agent brain to a call.

Get Started

Guides

Concepts

Reference

Integrations

Option 1: Call the API directly

Waiting for the call to end

Customizing voice and language

Prompting best practices

Option 2: Use the Poku Skill

​Option 1: Call the API directly

​Waiting for the call to end

​Customizing voice and language

​Prompting best practices

​Option 2: Use the Poku Skill

Option 1: Call the API directly

Waiting for the call to end

Customizing voice and language

Prompting best practices

Option 2: Use the Poku Skill