Sandbox quickstart

You need:

A development project UUID.
An organization key with sessions:read and sessions:manage.

Keep the credential on a trusted server.

1. Create a testing number

curl -X POST "https://api.polymorfa.com/v1/sessions/testing" \
  -H "Authorization: Bearer $TITAN_ORG_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "'"$PROJECT_ID"'",
    "name": "Quickstart sender",
    "country": "US"
  }'

projectId is required. country is optional and defaults to US; accepted values are US, GB, BR, and IN. The response contains the generated testing-session identifier.

2. List the project’s sessions

curl "https://api.polymorfa.com/v1/sessions?projectId=$PROJECT_ID" \
  -H "Authorization: Bearer $TITAN_ORG_KEY"

Select the row whose generated session identifier matches the create response. Testing-number rows have testMode: true.

3. Remove the testing number

curl -X DELETE \
  "https://api.polymorfa.com/v1/sessions/$SESSION_ID" \
  -H "Authorization: Bearer $TITAN_ORG_KEY"

Removal is permanent. Use the generated Platform API endpoint pages for the complete request, response, authorization, and error schemas.

Where to go next

Number pool

List and manage testing numbers.

Claims and devices

Open a testing session in the desktop app.

Sandbox limits

Review throughput and included data.

Authentication

Review credential audiences and scopes.

Get started

Console

Inspector

Sandbox

Integrations

Sandbox quickstart

1. Create a testing number

2. List the project’s sessions

3. Remove the testing number

Where to go next

Number pool

Claims and devices

Sandbox limits

Authentication

​1. Create a testing number

​2. List the project’s sessions

​3. Remove the testing number

​Where to go next

Number pool

Claims and devices

Sandbox limits

Authentication

1. Create a testing number

2. List the project’s sessions

3. Remove the testing number

Where to go next