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.
number*stringThe 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.
Idempotency-Key?stringUnique 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.
^[a-zA-Z0-9_-]+$length <= 255x-profile-id?stringProfile 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.
uuidapplication/json- body
Base request for mutation operations (POST, PUT, PATCH) with sandbox mode support
sandbox?booleanSandbox flag - when true, the operation is simulated without side effects Useful for testing integrations without actual execution
The test ran. Read outcome to see whether your endpoint passed
application/json- response
Standard API response envelope for all v3 endpoints
success?booleanIndicates whether the request was successful
data?|nullThe response data (null if error)
error?|nullError details (null if successful)
meta?Metadata about the request and response
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}'{ "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" }}Rotate a voice number's callback secret POST
Generates a new signing secret for the questions Sent sends to this number's callback URL and returns it. The previous secret stops signing immediately, so update your backend before the next call reaches it. The number is the E.164 value in the path with the plus sign URL-encoded (`%2B`). With `sandbox: true` a secret is generated and returned with `202`, and nothing is written.
Create a voice token POST
Mints a short-lived token for one of your app users. Call this from your backend and return the token to your app, which passes it to the voice client SDK to register. The identity is bound to the given number, or to your default app-call number when omitted, and calls placed by that identity are routed through the bound number. Minting again re-binds the identity, so an identity can move between numbers.