Create DID

Map a new incoming phone number (DID) to a specific conversational Voice Agent.

<div class="endpoint-path">
  <span class="badge badge-post">POST</span>
  <code>/v1/dids</code>
</div>

<h2>Request Body</h2>
<div class="param-row">
  <div class="param-name">didNumber</div>
  <div class="param-badges">
    <span class="badge-type">string</span>
    <span class="badge-req">required</span>
  </div>
  <div class="param-desc">The telephony number to bind.</div>
</div>

<div class="param-row">
  <div class="param-name">agentId</div>
  <div class="param-badges">
    <span class="badge-type">string</span>
    <span class="badge-req">required</span>
  </div>
  <div class="param-desc">Target agent to redirect the call streams.</div>
</div>

curl --request POST \
  --url https://api.branofy.cloud/v1/dids \
  --header 'X-API-Key: your_voice_api_secret_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "didNumber": "+15551234567",
    "agentId": "agent_12345"
  }'

<div class="response-preview">
  <div class="response-header">
    <span>Response</span>
    <span class="status-201">201 Created</span>
  </div>

{
  "id": "did_4455",
  "didNumber": "+15551234567",
  "agentId": "agent_12345",
  "provider": "voicelink",
  "isDefault": false,
  "updatedAt": "2026-06-21T16:11:00Z"
}

</div>