---
title: "Register a test phone number"
method: POST
path: "/v2/sandbox/numbers"
tags: ["Sandbox"]
---

# Register a test phone number

`POST /v2/sandbox/numbers`

## Request

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

## Request body

- PostV2SandboxNumbersRequestBody
  - `phoneNumber` string, required: E.164 phone number to register for testing
  - `label` string: Optional label for this number
  - `memberId` string, uuid: Member ID to assign this number to. Defaults to the authenticated member.

## Response `200`

POST /v2/sandbox/numbers Positive response

- PostV2SandboxNumbersPositiveResponse
  - `id` number, required
  - `phoneNumber` string, required
  - `label` string, nullable, required
  - `type` string, required
  - `memberId` string, uuid, nullable, required

## Other responses

- `400`: POST /v2/sandbox/numbers Negative response 400
- `401`: POST /v2/sandbox/numbers Negative response 401
- `403`: POST /v2/sandbox/numbers Negative response 403
- `404`: POST /v2/sandbox/numbers Negative response 404
- `409`: POST /v2/sandbox/numbers Negative response 409
- `422`: POST /v2/sandbox/numbers Negative response 422
- `429`: POST /v2/sandbox/numbers Negative response 429
- `500`: POST /v2/sandbox/numbers Negative response 500
- `502`: POST /v2/sandbox/numbers Negative response 502
- `503`: POST /v2/sandbox/numbers 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/9534fc3b0a65?raw)