Phone Numbers

Sync or manually add DIDs

Imports DIDs into Vocobase for inbound routing. For Plivo, Vocobase pulls the inventory from Plivo REST using the selected connection’s credentials. For Vobiz and MCube, pass an explicit numbers array because Vocobase does not pull DID inventory from those providers. MCube numbers must all be valid E.164 DIDs, and connection_id is required so the account-routing boundary is explicit. The operation is idempotent: existing DIDs and repeated request values are skipped. For other providers, connection_id is required whenever more than one active connection exists.

POST

phone-numbers

sync

curl --request POST \
  --url https://api.vocobase.com/api/v2/phone-numbers/sync \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "provider": "PLIVO",
  "connection_id": "9b7f1c44-c87f-4f0c-9124-3c802a9c1a20"
}
'

{
  "success": true,
  "data": {
    "imported": 2,
    "skipped": 1,
    "total_remote": 3
  }
}

Authorizations

Authorization

string

header

required

API key in format: rg_live_xxxx. Pass as a Bearer token in the Authorization header.

Body

application/json

Option 1
Option 2
Option 3

provider

string

required

Allowed value: "PLIVO"

connection_id

string<uuid>

Optional unless multiple active Plivo connections exist.

Response

Sync completed. Manual Vobiz and MCube imports report added and skipped values; repeated or existing DIDs are skipped.

success

boolean

data

object

Option 1
Option 2

Show child attributes

Re-apply carrier Application bindingsRe-applies the Vocobase answer/status Application binding to every assigned DID for the requested provider. Use this after rotating credentials, editing carrier-side settings directly, or validating that all assigned DIDs point back to Vocobase.

curl --request POST \
  --url https://api.vocobase.com/api/v2/phone-numbers/sync \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "provider": "PLIVO",
  "connection_id": "9b7f1c44-c87f-4f0c-9124-3c802a9c1a20"
}
'

{
  "success": true,
  "data": {
    "imported": 2,
    "skipped": 1,
    "total_remote": 3
  }
}

Getting Started

Guides

Partner Onboarding

API Reference

Webhooks

Telephony

Sync or manually add DIDs

Authorizations

Body

Response