Samva
Samva
DashboardAPISamva DocumentationQuickstart GuideAuthentication

Api referenceSms

Purchase Phone Number

POST
/sms/phone-numbers

Authorization

apiKey
X-API-Key<token>

API key for authentication

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X POST "https://samva.app/api/v1/sms/phone-numbers" \  -H "Content-Type: application/json" \  -d '{    "phoneNumber": "string"  }'
{
  "id": "string",
  "phoneNumber": "string",
  "friendlyName": "string",
  "capabilities": {
    "sms": true,
    "mms": true,
    "voice": true
  },
  "numberType": "local",
  "country": "string",
  "isDefault": true,
  "status": "string"
}
phoneNumber*string

Phone number to purchase (E.164 format)

Match^\+\d{10,15}$
friendlyName?string

Display name for the number

routingTags?array<>

Routing tags for intelligent selection

isDefault?boolean

Set as default number for org

Defaultfalse