Skip to main content

AddToPool adds a new DID to the inventory pool.

POST 
/api/v1/voice/admin/did-pool

Registers a phone number acquired from a provider into the platform's available inventory. The DID becomes available for allocation.

Parameters​

  • number: Required, E.164 formatted phone number
  • country_code: Required, ISO 3166-1 alpha-2 code (US, GB, DE)
  • number_type: Required, type of number (local, mobile, tollfree, national)
  • provider: Optional, source provider (twilio, vonage, manual)
  • provider_id: Optional, provider's ID for this number
  • monthly_cost_cents: Required, monthly cost in cents
  • setup_cost_cents: Required, one-time setup cost in cents
  • capabilities: Optional, voice/SMS/MMS/fax capabilities
  • metadata: Optional, additional key-value metadata

Response​

Returns the created pool item with status = available.

Errors​

  • ALREADY_EXISTS: Number already in pool
  • INVALID_ARGUMENT: Invalid country code or number format
  • PERMISSION_DENIED: Caller lacks voice:admin permission

Request​

Responses​

A successful response.