Transfer Number

During an outbound call, the voice agent will transfer to your transfer number if (1) the person on the line explicitly asks to speak with a human or (2) if you specify any transfer conditions in the prompt. This gives the other party a way to reach you directly if needed — for example, if they have a question the agent can’t answer or want to confirm details personally.

Option 1: Via the API

Pass transferTo in your call request:

curl -X POST https://api.pokulabs.com/calls \
  -H "Authorization: Bearer <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "<drafted prompt>",
    "to": "<destination number>",
    "transferTo": "+12223334444"
  }'

Parameter	Type	Required	Description
`prompt`	string	Yes	Structured prompt that drives the voice AI agent.
`to`	string	Yes	Destination phone number in E.164 format.
`transferTo`	string	No	Number to transfer the call to if the other party asks to speak with a human. Must be E.164 format.

See Supported Countries for eligible destinations.

Option 2: Via the Poku Skill

Set POKU_TRANSFER_NUMBER in your Poku Skill environment config to apply a permanent transferTo across all calls placed by the skill — no need to pass it on each request.

{
  "skills": {
    "entries": {
      "poku": {
        "enabled": true,
        "apiKey": "<your-poku-api-key>",
        "env": {
          "POKU_TRANSFER_NUMBER": "+12223334444"
        }
      }
    }
  }
}

See Poku Skill for full installation instructions.

Get Started

Guides

Concepts

Reference

Integrations

Option 1: Via the API

Option 2: Via the Poku Skill

​Option 1: Via the API

​Option 2: Via the Poku Skill

Option 1: Via the API

Option 2: Via the Poku Skill