Sandbox

API reference descriptions are provided in English to preserve the exact published contract.

GETgetV1AccountsByAcRealTestrealTest.list
GETgetV1AccountsByAcRealTestEventsrealTest.events.list
GETgetV1AccountsByAcRealTestMessagesrealTest.messages.list
POSTpostV1AccountsByAcRealTestMessagesrealTest.messages.create
GETgetV1AccountsByAcRealTestMessagesByAttemptidrealTest.messages.retrieve
POSTpostV1AccountsByAcRealTestRecipientsrealTest.recipients
POSTpostV1AccountsByAcRealTestRecipientsByRecipientidOptOutrealTest.recipients.optOut
POSTpostV1AccountsByAcRealTestRecipientsByRecipientidRejoinrealTest.recipients.rejoin
POSTpostV1AccountsByAcRealTestRecipientsByRecipientidRemoverealTest.recipients.remove
POSTpostV1AccountsByAcRealTestRecipientsByRecipientidVerifyrealTest.recipients.verify
POSTExecute an allow-listed request with an owned sandbox keysandboxExplorer.create

realTest.list

GET/v1/accounts/{AC}/real-test

realTest.listSDK operation getV1AccountsByAcRealTest

Required scope: messages:read.

GET /v1/accounts/{AC}/real-test

curl "https://api.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/real-test" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21"

Responses

realTest.events.list

GET/v1/accounts/{AC}/real-test/events

realTest.events.listSDK operation getV1AccountsByAcRealTestEvents

Required scope: messages:read.

GET /v1/accounts/{AC}/real-test/events

curl "https://api.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/real-test/events" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21"

Responses

realTest.messages.list

GET/v1/accounts/{AC}/real-test/messages

realTest.messages.listSDK operation getV1AccountsByAcRealTestMessages

Required scope: messages:read.

Parameters

limitinteger (1–100)query

GET /v1/accounts/{AC}/real-test/messages

curl "https://api.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/real-test/messages" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21"

Responses

realTest.messages.create

POST/v1/accounts/{AC}/real-test/messages

realTest.messages.createSDK operation postV1AccountsByAcRealTestMessages

Required scope: messages:send.Idempotency-Key required

Request body

acknowledgeRealContacttrueRequired
idempotencyKeystring (max 255 chars)Required
recipientIdstring (uuid)Required
textstring (max 4096 chars)Required

POST /v1/accounts/{AC}/real-test/messages

curl -X POST "https://api.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/real-test/messages" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "acknowledgeRealContact": "string",
  "idempotencyKey": "string",
  "recipientId": "3f2b1c9e-8d4a-4b5f-9a61-0c7e2d1b4a55",
  "text": "string"
}'

Responses

realTest.messages.retrieve

GET/v1/accounts/{AC}/real-test/messages/{attemptId}

realTest.messages.retrieveSDK operation getV1AccountsByAcRealTestMessagesByAttemptid

Required scope: messages:read.

Parameters

attemptIdstring (uuid)Required

GET /v1/accounts/{AC}/real-test/messages/{attemptId}

curl "https://api.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/real-test/messages/attemptId..." \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21"

Responses

realTest.recipients

POST/v1/accounts/{AC}/real-test/recipients

realTest.recipientsSDK operation postV1AccountsByAcRealTestRecipients

Required scope: senders:write.Idempotency-Key required

Request body

acknowledgeRealContacttrueRequired
phonestring (max 30 chars)Required
idempotencyKeystring (uuid)

POST /v1/accounts/{AC}/real-test/recipients

curl -X POST "https://api.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/real-test/recipients" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "acknowledgeRealContact": "string",
  "phone": "string"
}'

Responses

realTest.recipients.optOut

POST/v1/accounts/{AC}/real-test/recipients/{recipientId}/opt-out

realTest.recipients.optOutSDK operation postV1AccountsByAcRealTestRecipientsByRecipientidOptOut

Required scope: senders:write.Idempotency-Key required

Parameters

recipientIdstring (uuid)Required

POST /v1/accounts/{AC}/real-test/recipients/{recipientId}/opt-out

curl -X POST "https://api.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/real-test/recipients/recipientId.../opt-out" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21" \
  -H "Idempotency-Key: $(uuidgen)"

Responses

realTest.recipients.rejoin

POST/v1/accounts/{AC}/real-test/recipients/{recipientId}/rejoin

realTest.recipients.rejoinSDK operation postV1AccountsByAcRealTestRecipientsByRecipientidRejoin

Required scope: senders:write.Idempotency-Key required

Parameters

recipientIdstring (uuid)Required

POST /v1/accounts/{AC}/real-test/recipients/{recipientId}/rejoin

curl -X POST "https://api.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/real-test/recipients/recipientId.../rejoin" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21" \
  -H "Idempotency-Key: $(uuidgen)"

Responses

realTest.recipients.remove

POST/v1/accounts/{AC}/real-test/recipients/{recipientId}/remove

realTest.recipients.removeSDK operation postV1AccountsByAcRealTestRecipientsByRecipientidRemove

Required scope: senders:write.Idempotency-Key required

Parameters

recipientIdstring (uuid)Required

POST /v1/accounts/{AC}/real-test/recipients/{recipientId}/remove

curl -X POST "https://api.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/real-test/recipients/recipientId.../remove" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21" \
  -H "Idempotency-Key: $(uuidgen)"

Responses

realTest.recipients.verify

POST/v1/accounts/{AC}/real-test/recipients/{recipientId}/verify

realTest.recipients.verifySDK operation postV1AccountsByAcRealTestRecipientsByRecipientidVerify

Required scope: senders:write.Idempotency-Key required

Parameters

recipientIdstring (uuid)Required

Request body

codestring (max 100 chars)Required

POST /v1/accounts/{AC}/real-test/recipients/{recipientId}/verify

curl -X POST "https://api.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/real-test/recipients/recipientId.../verify" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "code": "string"
}'

Responses

Execute an allow-listed request with an owned sandbox key

POST/v1/accounts/{AC}/sandbox-explorer

sandboxExplorer.createSDK operation postV1AccountsByAcSandboxExplorer

Required scope: api:access.Idempotency-Key required

Request body

apiKeySidstring (SK… SID)Required
methodenumRequired
GETDELETEPOSTPUTPATCH
pathstring (max 1000 chars)Required
bodyany
executionKeystring (uuid)

POST /v1/accounts/{AC}/sandbox-explorer

curl -X POST "https://api.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/sandbox-explorer" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "apiKeySid": "SK...",
  "method": "GET",
  "path": "string"
}'

Responses