---
title: "Initiate a sandbox outbound test call"
method: POST
path: "/v2/sandbox/calls"
tags: ["Sandbox"]
---

# Initiate a sandbox outbound test call

`POST /v2/sandbox/calls`

## Request

- Base URL: `https://api.carecycle.ai`
- URL: `https://api.carecycle.ai/v2/sandbox/calls`
- Auth: API key in header `x-api-key`

## Request body

- PostV2SandboxCallsRequestBody
  - `campaignId` string, uuid, required
  - `assistantId` string, required
  - `phoneNumber` string: E.164 phone number to call. Auto-resolved from your registered test number if omitted.
  - `clientId` string, uuid: Target client organization ID. Super admin only; omit to use your own organization.
  - `customerData` object: Customer profile and policy fields to set on the test customer before calling. Accepts any clientCustomer field (firstName, lastName, postalCode, timezone, dateOfBirth, state, etc.) and policy fields (carrierName, planName, planCode, effectiveDate, enrollmentDate). Protected fields (id, clientId, callerId) are ignored.

## Response `200`

POST /v2/sandbox/calls Positive response

- PostV2SandboxCallsPositiveResponse
  - `callId` string, uuid, required
  - `testCustomerId` string, uuid, required
  - `status` 'initiated' | 'missing_variables', required
  - `missingVars` string[]
  - `availableVars` object
  - `requiredVars` string[]

## Other responses

- `400`: POST /v2/sandbox/calls Negative response 400
- `401`: POST /v2/sandbox/calls Negative response 401
- `403`: POST /v2/sandbox/calls Negative response 403
- `404`: POST /v2/sandbox/calls Negative response 404
- `409`: POST /v2/sandbox/calls Negative response 409
- `422`: POST /v2/sandbox/calls Negative response 422
- `429`: POST /v2/sandbox/calls Negative response 429
- `500`: POST /v2/sandbox/calls Negative response 500
- `502`: POST /v2/sandbox/calls Negative response 502
- `503`: POST /v2/sandbox/calls Negative response 503

---

[API](https://skmtc.dev/carecycle/apis/carecycle-public-api.md) - [All operations](https://skmtc.dev/carecycle/apis/carecycle-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/carecycle/apis/carecycle-public-api/revisions/db390c743c36?raw)