Skip to main content

CreateDID registers a new phone number for the organization.

POST 
/api/v1/voice/dids

Creates a DID that can receive inbound calls and be assigned to agents for outbound caller ID.

Parameters​

  • number: Required, E.164 formatted phone number (10-20 chars)
  • call_flow_id: Optional, call flow for inbound routing

Response​

Returns the created DID with generated ID.

Side Effects​

  • Creates DID record in application database
  • Number becomes available for agent assignment

Errors​

  • ALREADY_EXISTS: DID with same number exists
  • INVALID_ARGUMENT: Invalid phone number format
  • NOT_FOUND: Referenced call_flow_id not found
  • PERMISSION_DENIED: Caller lacks voice:did:write permission

Request​

Responses​

A successful response.