Create Tool

Register a new custom tool/function that voice agents can trigger over HTTP webhooks.

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

<h2>Request Body</h2>
<div class="param-row">
  <div class="param-name">name</div>
  <div class="param-badges">
    <span class="badge-type">string</span>
    <span class="badge-req">required</span>
  </div>
  <div class="param-desc">Technical function name.</div>
</div>

<div class="param-row">
  <div class="param-name">httpEndpoint</div>
  <div class="param-badges">
    <span class="badge-type">string</span>
    <span class="badge-req">required</span>
  </div>
  <div class="param-desc">Absolute URL target for the agent's function payload call.</div>
</div>

curl --request POST \
  --url https://api.branofy.cloud/v1/tools \
  --header 'X-API-Key: your_voice_api_secret_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "lookup_user",
    "description": "Fetch user detail records",
    "httpEndpoint": "https://api.branofy.cloud/v1/users/lookup",
    "method": "POST"
  }'

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

{
  "id": "tool_def456",
  "name": "lookup_user",
  "description": "Fetch user detail records",
  "httpEndpoint": "https://api.branofy.cloud/v1/users/lookup",
  "method": "POST",
  "isActive": true
}

</div>