---
title: "Make a test outbound call"
method: POST
path: "/playground/test-call"
tags: ["Playground"]
---

# Make a test outbound call

`POST /playground/test-call`

Make a test outbound call to a verified phone number for your organization.

    This endpoint is designed for testing your agent configuration before
    deploying to production. The call will be made to one of your organization's
    verified phone numbers.

    ## Requirements
    - API Key with WRITE permission and MAKE_OUTBOUND_CALLS tier permission
    - Agent must be of type OUTBOUND
    - Agent must have all required fields configured (voice, language, etc.)
    - Target phone number must be in your organization's verified phone numbers list

    ## Use Cases
    - Test agent configuration before going live
    - Verify agent voice and conversation flow
    - Test custom context and prompts
    - Quality assurance for agent updates

    ## Response
    Returns a task ID that can be used to track the call execution status.
    The call will be initiated asynchronously, and you should receive the call shortly.

## Request body

- object — Request model for making a test outbound call via External API.
  - `agent_id` string, uuid, required — ID of the outbound agent to use for the test call
  - `to_number` string, required — Phone number to call (must be in your organization's verified phone numbers list)

## Response `201`

Test call successfully queued

- object
  - `ok` boolean, required
  - `data` object, nullable — Response model for test outbound call request.
    - `status` string, required — Status of the test call request
    - `message` string, required — Human readable message about the test call
    - `task_id` string, nullable — Celery task ID for tracking the call execution
    - `agent_id` string, required — ID of the agent used for the call
    - `from_number` string, required — Phone number the call was initiated from
    - `to_number` string, required — Phone number being called
  - `meta` object, nullable
    - `limit` integer, required
    - `offset` integer, required
    - `total_items` integer, required
  - `error` object, nullable
    - `code` string, required
    - `message` string, required
    - `details` union
      - string
      - string[]
      - object

## Other responses

- `400` — Bad request - agent is not OUTBOUND type or other validation error
- `403` — Forbidden - organization lacks permissions or agent has missing required fields
- `404` — Not found - agent not found or phone number not in verified list
- `500` — Internal server error - failed to enqueue call

---

[API](https://skmtc.net/yourang/apis/yourang-ai-external-api-v1.md) · [All operations](https://skmtc.net/yourang/apis/yourang-ai-external-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yourang/yourang-ai-external-api-v1/revisions/49680ee64400/schema)