Test a voice number's callback URL

Sends a synthetic call.request question, flagged "test": true, to the number's callback URL, signed with that number's real secret, and reports what came back. Use it to build and debug your callback endpoint without placing calls: no call is placed, nothing is billed, and nothing is stored. One attempt with the same deadline as a live call, no retry. The outcome is ok when your endpoint answered 2xx with a valid answer; otherwise it is timeout, connection_failed, http_error or invalid_answer, with the reason and, for an invalid answer, the field at fault. The number is the E.164 value in the path with the plus sign URL-encoded (%2B).

With sandbox: true nothing is sent: the verdict comes back ok with 202 and no request or response in it.

POST
/v3/channels/voice/{number}/test

Path Parameters

number*string

The voice number from the route, in E.164 format with the plus sign URL-encoded (%2B), for example /v3/channels/voice/%2B12025550123/test. The test question goes to this number's callback URL and is signed with this number's secret.

Header Parameters

Idempotency-Key?string

Unique key to ensure idempotent request processing. Must be 1-255 alphanumeric characters, hyphens, or underscores. Responses are cached for 24 hours per key per customer.

Match^[a-zA-Z0-9_-]+$
Lengthlength <= 255
x-profile-id?string

Profile UUID to scope the request to a child profile. Only organization API keys can use this header. The profile must belong to the calling organization.

Formatuuid

Request Body

application/json
  1. body

Base request for mutation operations (POST, PUT, PATCH) with sandbox mode support

sandbox?boolean

Sandbox flag - when true, the operation is simulated without side effects Useful for testing integrations without actual execution

Response Body

The test ran. Read outcome to see whether your endpoint passed

application/json
  1. response

Standard API response envelope for all v3 endpoints

success?boolean

Indicates whether the request was successful

data?|null

The response data (null if error)

error?|null

Error details (null if successful)

meta?

Metadata about the request and response

Example Request
curl -X POST 'https://api.sent.dm/v3/channels/voice/+12025550123/test' \  -H 'Idempotency-Key: req_abc123_retry1' \  -H 'Content-Type: application/json' \  -d '{  "sandbox": false}'
Example Response
{  "success": true,  "data": {    "outcome": "ok",    "call_id": "call_9f2ab000-0000-4000-8000-000000000001",    "request": {      "url": "https://example.com/voice",      "headers": {        "User-Agent": "SentDM-Voice/1.0",        "X-Webhook-ID": "7c9e6679-7425-40de-944b-e07fc1f90ae7",        "X-Webhook-Timestamp": "1784721600",        "X-Webhook-Signature": "v1,xJ/WfHm26o0BBWZ/SIDmZio7C3BbqlcbxvO/QIZpjUA=",        "X-Request-Id": "req_7X9zKp2jDw"      },      "body": "{\"type\":\"call.request\",\"version\":\"1\",\"callId\":\"call_9f2ab000-0000-4000-8000-000000000001\",\"number\":\"+12025550123\",\"timestamp\":\"2026-07-22T12:00:00+00:00\",\"test\":true,\"direction\":\"outbound\",\"from\":{\"kind\":\"user\",\"identity\":\"test-user\"},\"to\":{\"kind\":\"number\",\"number\":\"+12025550142\"}}"    },    "response": {      "status_code": 200,      "body": "{ \"action\": { \"action\": \"connectToUser\", \"identity\": \"agent-42\" } }"    },    "answer": {      "valueKind": "Object"    },    "error": null  },  "error": null,  "meta": {    "request_id": "req_7X9zKp2jDw",    "timestamp": "2026-11-12T15:32:26.8719327+00:00",    "version": "v3"  }}