---
title: "Place Outbound Test Call"
method: POST
path: "/outbound-test-calls/"
tags: ["Outbound Test Calls"]
---

# Place Outbound Test Call

`POST /outbound-test-calls/`

Place a one-off outbound test call to an arbitrary number.

The call is flagged `is_test=True` and no outbound lead is created.

## Request body

- PlaceOutboundTestCallRequest — Request to place a one-off outbound test call to an arbitrary number.
  - `customer_number` string, required — Phone number to dial
  - `first_name` string, nullable — Contact first name
  - `last_name` string, nullable — Contact last name
  - `phone_number_id` string, uuid, nullable — Internal phone number ID to dial from. Optional when the customer has exactly one ready number.
  - `trigger_metadata` object, nullable — Values for the customer's configured trigger fields (e.g. {"lead_source": "instagram_ad"})

## Response `201`

Successful Response

- PlaceOutboundTestCallResponse — Response from placing an outbound test call.
  - `call_id` string, uuid, required — Internal call record ID
  - `phone_number` string, required — The number the call was placed from
  - `status` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/openintake/apis/fastapi.md) · [All operations](https://skmtc.dev/openintake/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openintake/fastapi/revisions/b642b91e0a5c/schema)
